home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / lib232.zip / LIBERATE.DOC < prev    next >
Text File  |  1990-10-14  |  185KB  |  3,487 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                             The  L i b e r a t o r (TM)
  25.  
  26.                         PCBoard Automation System for Telix
  27.  
  28.                                    Version 2.32
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                   Copyright (C) 1989, 1990 Liberation Enterprises
  45.  
  46.                                ALL RIGHTS RESERVED.
  47.  
  48.  
  49.  
  50.  
  51.      COPYRIGHT NOTICE
  52.  
  53.       This program is not in the public domain.  All files that accompany The
  54.       Liberator including this documentation are Copyright 1989, 1990
  55.       Liberation Enterprises.  The Liberator is a Trademark of Liberation
  56.       Enterprises.
  57.  
  58.      DISCLAIMER
  59.  
  60.       The Liberator and its documentation is distributed and sold AS IS,
  61.       without warranty of any kind as to performance of merchantability,
  62.       fitness for a particular purpose, or any other warranties, either
  63.       express or implied.  Neither Liberation Enterprises nor its dealers or
  64.       distributors shall be liable to the user/purchaser or any other person
  65.       or entity with respect to any liability, loss, or damage caused or
  66.       alleged to be caused directly or indirectly by the software or its
  67.       documentation.
  68.  
  69.      LICENSE
  70.  
  71.       You are licensed to use this evaluation copy of The Liberator at no
  72.       charge for a limited evaluation period.  Once you are satisfied that
  73.       the program is useful to you, after a reasonable evaluation period (30
  74.       days), you must register your copy.  To do so, complete the registra-
  75.       tion form and mail it along with the fee as outlined on the form.  Re-
  76.       distribution of The Liberator is encouraged, but must comply with the
  77.       following:
  78.  
  79.       1. The Liberator may not be sold commercially or distributed with any
  80.          other programs without written permission from Liberation Enter-
  81.          prises.
  82.  
  83.       2. No charges other than reasonable overhead and/or copying fees may be
  84.          levied for distribution of The Liberator ($10 or less).
  85.  
  86.       3. The program files and documentation must be distributed in their
  87.          entirety and must remain absolutely unmodified.  Please do not
  88.          distribute the program in an incomplete state.
  89.      ----
  90.  
  91.       PCBoard is a registered trademark of Clark Development Company, Inc.  
  92.  
  93.       ProLogon, ProBank, and ProDoor are Copyright by Samuel H. Smith.
  94.  
  95.       Qmail and Deluxe are Copyright by Mark Herring of Sparkware.  Post
  96.       Office Box 38216 Germantown, TN 38183-0216.
  97.  
  98.       Telix and SALT are trademarks of and Copyright by Exis Inc.  Post
  99.       Office Box 130, West Hill, Ont., Canada  M1E 4R4.  Telix Support BBS
  100.       (modem only): (416) 439-8293.
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.                                          2
  111.  
  112.  
  113.  
  114.  
  115.      User-Supported Software: Try BEFORE you buy!
  116.  
  117.      User-supported software, such as The Liberator, is software that you try
  118.      on your own computer for a limited 'evaluation period'.  During this
  119.      period, you decide whether the program is useful to you, and make up
  120.      your mind whether you wish to continue using it and pay for it, or stop
  121.      using it and not pay.  Of course, another choice is not to pay and
  122.      continue using the program anyway.
  123.  
  124.      Unfortunately, from previous experience, and from what I've heard from
  125.      many developers, the third choice is the one a great majority of people
  126.      make -- even for useful, quality products.  However, ulterior motives
  127.      aside, it is definitely the wrong choice to make.  Especially from a
  128.      user point of view.
  129.  
  130.      The reason is this.  There are many companies developing software for
  131.      your computer.  Some of this software will be marketed in the tradition-
  132.      al way, in which the developer pays thousands, or more likely millions
  133.      of dollars for marketing, advertising, packaging, and distribution. 
  134.      Initially these expenses may be paid from the developer's pocket: but it
  135.      is inevitable that the extra expense be passed on to you in the price of
  136.      the software.  Thus you end up not only paying for the software, but
  137.      also for expensive ads in computer magazines, and flashy packaging which
  138.      will probably end up in the garbage.  Worse than this, you may install
  139.      the software and find that it does not do what the ad said it would do,
  140.      or that they forgot to tell you about incompatibilies, etc.  The end-
  141.      result?  You paid more, filled the pockets of advertisers, and got less
  142.      -- or even something that may sit on your shelf collecting dust (we all
  143.      have a few of these programs).
  144.  
  145.      On the other hand, some software is released under the premise that
  146.      people don't need flashy advertisements or packaging to determine
  147.      whether they are interested in a product.  The best advertising for a
  148.      product should be the product itself, and this is the concept User-
  149.      Supported Software employs.  There is no chance of misleading you into
  150.      making a purchase with dazzling packaging or advertisements since all
  151.      this is stripped away, and only the product remains.  However, in order
  152.      to let you try the product, it must be made available... and this means
  153.      that you already have the product before paying for it.
  154.  
  155.      Is this an invitation to steal the software?  Some people look at it
  156.      that way.  But if you use common sense, you will realize that if you
  157.      don't pay, eventually developers will be forced to add registration
  158.      gimmicks (a new feature in this release of The Liberator), which almost
  159.      always prevent you from evaluating the full product, though I did not
  160.      choose that technique.  If gimmicks fail, there is no choice but to
  161.      ensure customers pay ahead of time... leading to all the extra expense
  162.      and problems of traditional distribution.  If traditional marketing
  163.      isn't practical, the developer may be forced to shelve the product,
  164.      since not many developers are willing to work hours on end, forever, for
  165.      nothing.  If this happens, everyone loses.
  166.  
  167.      Thus, it has been left it up to you to decide.  Don't look upon
  168.      registration as doing some sort of good deed... Register (the products
  169.      you use) to do *yourself* a favour and keep the 'Try BEFORE you buy'
  170.      concept strong!
  171.  
  172.  
  173.  
  174.                                          3
  175.  
  176.  
  177.  
  178.      The  L i b e r a t o r  v2.32                    Registration Form C-08.
  179.      ------------------------------------------------------------------------
  180.      Please print clearly.                [Office use] R#        D/R
  181.      ------------------------------------------------------------------------
  182.  
  183.         Name: ___________________________________________________________
  184.  
  185.      Company: ___________________________________________________________
  186.  
  187.      Address: ___________________________________________________________
  188.  
  189.         City: _________________________   Prov./State: __________________
  190.  
  191.          ZIP: _________________________         Phone: (_____)___________
  192.  
  193.      Country: ___________________________________________________________
  194.  
  195.  
  196.                  Quantity      Price per registration
  197.                  ------------------------------------
  198.                   1 - 10       $24.95
  199.                  11 - 20        19.95
  200.                  21 - 50        14.95
  201.                    51+           9.95
  202.  
  203.      # of Copies _______  x  $________ per reg. = Sub Total $____________
  204.  
  205.                    Ont. residents, add Provincial Sales Tax  ____________
  206.  
  207.                    Outside North America add $3.00 shipping +____________
  208.  
  209.                                                       TOTAL $____________
  210.  
  211.      One registered copy is sent (one 360K disk), plus a license to install
  212.      the # of copies registered.  Orders are accepted in Canadian or U.S.
  213.      currency.  Please mail your check, or M.O. to [NOTE: Postage to Canada
  214.      from the U.S. was 5 cents extra at release date.]:
  215.  
  216.              Liberation Enterprises, 3091 Eglinton Ave E., Suite 602,
  217.                          Scarboro, Ont., CANADA  M1J 2G1.
  218.  
  219.      Where did you obtain The Liberator?
  220.  
  221.      ____________________________________________________________________
  222.  
  223.      What do you use The Liberator for mainly (most important feature)?
  224.  
  225.      ____________________________________________________________________
  226.  
  227.      ____________________________________________________________________
  228.  
  229.      What improvements or new features would you like to see added to the
  230.      program in the future?  (Use back of page if necessary.)
  231.  
  232.      ____________________________________________________________________
  233.  
  234.      ____________________________________________________________________
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                                  TABLE OF CONTENTS
  241.  
  242.  
  243.      1.  INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . . .    1
  244.          1.1  Liberator v2.32 Features . . . . . . . . . . . . . . . . .    1
  245.          1.2  How To Use The Tutorial  . . . . . . . . . . . . . . . . .    3
  246.  
  247.      2.  GETTING STARTED . . . . . . . . . . . . . . . . . . . . . . . .    4
  248.          2.1  Liberator First Startup  . . . . . . . . . . . . . . . . .    4
  249.          2.2  Registration Reminder Screen . . . . . . . . . . . . . . .    5
  250.          2.3  BBS Configuration Files  . . . . . . . . . . . . . . . . .    5
  251.          2.4  Editing Screen Entries . . . . . . . . . . . . . . . . . .    6
  252.          2.5  Command Files  . . . . . . . . . . . . . . . . . . . . . .    7
  253.          2.6  The Command File Manager . . . . . . . . . . . . . . . . .    8
  254.          2.7  Print a BBS Configuration Form . . . . . . . . . . . . . .    8
  255.          2.8  Dialing Directory Setup  . . . . . . . . . . . . . . . . .    8
  256.          2.9  What are Protocols?  . . . . . . . . . . . . . . . . . . .    9
  257.          2.10 What are Batch Protocols?  . . . . . . . . . . . . . . . .    9
  258.          2.11 Enter Your Password  . . . . . . . . . . . . . . . . . . .   10
  259.          2.12 Dial the BBS . . . . . . . . . . . . . . . . . . . . . . .   10
  260.  
  261.      3.  PCBOARD SETUP . . . . . . . . . . . . . . . . . . . . . . . . .   12
  262.          3.1  Checking For Batch Transfer Support  . . . . . . . . . . .   12
  263.          3.2  Checking the PCBoard Version Number  . . . . . . . . . . .   12
  264.          3.3  Setting Up Protocols . . . . . . . . . . . . . . . . . . .   13
  265.          3.4  Searching For Liberator Configurations . . . . . . . . . .   13
  266.          3.5  Joining Conferences  . . . . . . . . . . . . . . . . . . .   14
  267.          3.6  Turning Expert Mode On . . . . . . . . . . . . . . . . . .   14
  268.          3.7  Viewing the available DOORS  . . . . . . . . . . . . . . .   14
  269.          3.8  ProDoor Setup  . . . . . . . . . . . . . . . . . . . . . .   15
  270.          3.9  Mail Door Setup  . . . . . . . . . . . . . . . . . . . . .   15
  271.  
  272.      4.  MAIL READER SETUP . . . . . . . . . . . . . . . . . . . . . . .   18
  273.          4.1  Choosing a Reader  . . . . . . . . . . . . . . . . . . . .   18
  274.          4.2  Configuring the Reader . . . . . . . . . . . . . . . . . .   18
  275.  
  276.      5.  LIBERATOR CONFIGURATION FILES . . . . . . . . . . . . . . . . .   19
  277.          5.1  Installing A Pre-defined Configuration . . . . . . . . . .   19
  278.          5.2  Configuration File Setup . . . . . . . . . . . . . . . . .   19
  279.          5.3  PCBoard Setup Screen   . . . . . . . . . . . . . . . . . .   19
  280.          5.4  PCBoard Prompts Screen . . . . . . . . . . . . . . . . . .   24
  281.          5.5  Pro Utilities Screen . . . . . . . . . . . . . . . . . . .   24
  282.          5.6  Mail Door Setup Screen . . . . . . . . . . . . . . . . . .   25
  283.          5.7  Saving a Configuration File  . . . . . . . . . . . . . . .   27
  284.          5.8  Cloning or Editing Configuration Files . . . . . . . . . .   27
  285.  
  286.      6.  LIBERATOR COMMAND FILES . . . . . . . . . . . . . . . . . . . .   28
  287.          6.1  Running Command Files  . . . . . . . . . . . . . . . . . .   31
  288.          6.2  Command File Abort Codes . . . . . . . . . . . . . . . . .   31
  289.          6.3  Pausing Or Manually Aborting Command Files . . . . . . . .   31
  290.          6.4  Creating New Command Files . . . . . . . . . . . . . . . .   32
  291.          6.5  Editing Existing Command Files . . . . . . . . . . . . . .   32
  292.          6.6  Deleting Command/Configuration Files . . . . . . . . . . .   32
  293.          6.7  Renaming Command/Configuration Files . . . . . . . . . . .   32
  294.  
  295.      7.  LIBERATOR CONFIGURATION (Tools 'Configure' option)  . . . . . .   33
  296.  
  297.      8.  SETTING UP CUSTOM COMMANDS  . . . . . . . . . . . . . . . . . .   34
  298.          8.1  Defining a PCBoard or ProDoor Command  . . . . . . . . . .   34
  299.          8.2  Sending More Than One Command  . . . . . . . . . . . . . .   35
  300.  
  301.  
  302.  
  303.  
  304.          8.3  Automatically Handled Prompts  . . . . . . . . . . . . . .   35
  305.          8.4  Some Useful Commands . . . . . . . . . . . . . . . . . . .   35
  306.          8.5  Running Other Telix Scripts  . . . . . . . . . . . . . . .   37
  307.          8.6  Passing Parameters To Scripts  . . . . . . . . . . . . . .   37
  308.          8.7  Replaceable Parameters?  . . . . . . . . . . . . . . . . .   38
  309.          8.8  External Script Return Values - IMPORTANT  . . . . . . . .   38
  310.  
  311.      9.  FILE TRANSFERS  . . . . . . . . . . . . . . . . . . . . . . . .   39
  312.          9.1  Sending Files (Uploading) To PCBoard . . . . . . . . . . .   39
  313.          9.2  Comments On File Lists (//)  . . . . . . . . . . . . . . .   39
  314.          9.3  Optional File List Items (Switches)  . . . . . . . . . . .   40
  315.          9.4  Specifying Upload or Download Passwords (/u /d)  . . . . .   40
  316.          9.5  Joining Specific Conferences (/#nnn) . . . . . . . . . . .   40
  317.          9.6  Making File List Items Permanent (/P)  . . . . . . . . . .   41
  318.          9.7  Using Switches On Separate Lines . . . . . . . . . . . . .   41
  319.          9.8  Specifying A Drive/Directory . . . . . . . . . . . . . . .   42
  320.          9.9  Upload Descriptions  . . . . . . . . . . . . . . . . . . .   42
  321.          9.10 Backup Lists . . . . . . . . . . . . . . . . . . . . . . .   43
  322.          9.11 Demonstration Upload List  . . . . . . . . . . . . . . . .   43
  323.          9.12 Telix Batch Upload Limitation  . . . . . . . . . . . . . .   43
  324.          9.13 Receiving Files (Downloading) From PCBoard . . . . . . . .   44
  325.          9.14 Using LIST.COM to create Download Lists  . . . . . . . . .   44
  326.  
  327.      10. USING THE MASTER  . . . . . . . . . . . . . . . . . . . . . . .   45
  328.          10.1  Creating a Master . . . . . . . . . . . . . . . . . . . .   45
  329.          10.2  Using the Add Option  . . . . . . . . . . . . . . . . . .   45
  330.          10.3  Using the Remove Option . . . . . . . . . . . . . . . . .   46
  331.          10.4  Running the Master  . . . . . . . . . . . . . . . . . . .   46
  332.          10.5  Using EXIT and REPEAT to Create Multiple Masters  . . . .   46
  333.          10.6  The Master Queue  . . . . . . . . . . . . . . . . . . . .   47
  334.          10.7  Using the Master To Link Command Files  . . . . . . . . .   49
  335.          10.8  Command File Differences Under RunMaster  . . . . . . . .   49
  336.  
  337.      11. CONFIGURING LIBERATOR PROMPTS . . . . . . . . . . . . . . . . .   51
  338.  
  339.      12. ABORT CODES/REMEDIES  . . . . . . . . . . . . . . . . . . . . .   53
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.                                          6
  361.  
  362.  
  363.  
  364.  
  365.      The  L i b e r a t o r  v2.32                      Introduction - Page 1
  366.      
  367.      
  368.  
  369.                                  1.  INTRODUCTION
  370.  
  371.  
  372.      Welcome, and thank you for your interest in The Liberator PCBoard
  373.      Automation System for Telix!  The Liberator will carry out entire
  374.      PCBoard sessions for you, totally unattended, right from dialing to 
  375.      logoff.  All the major jobs you would normally do manually can be
  376.      carried out by The Liberator, completely unattended, while you are doing
  377.      something more productive and exciting.  You can even leave The
  378.      Liberator on its own over a period of weeks, carrying out up to 100
  379.      separate PCBoard sessions, at pre-specified times each day!
  380.  
  381.      1.1  Liberator v2.32 Features
  382.  
  383.      > Full automation for PCBoard, Qmail v2, v3, and v4 doors, MarkMail
  384.        doors, MegaMail/NetMail/PCRelay doors, ProDoor, ProLogon and ProBank! 
  385.        Full ProLogon support is built in, and since The Liberator can operate
  386.        in ProDoor it can also handle ProLogon boards where the S)ystem
  387.        command has been disabled, preventing use of PCBoard itself.
  388.  
  389.      > Designed for easy setup -- no knowledge of Telix SALT required.  Even
  390.        a beginner can set up The Liberator with little difficulty.  Those not
  391.        familiar with PCBoard and its doors can make especially good use of
  392.        The Liberator and will be taken through all the necessary steps for
  393.        setup.  Even PCBoard experts will be impressed with the number of
  394.        tasks The Liberator knows how to do, its flexibility, and the speed
  395.        with which it carries tasks out!
  396.  
  397.      > Completely unattended operation.  The Liberator is larger than other
  398.        scripts mainly because it was designed to handle just about any error
  399.        that might occur.  Dozens of individual prompts and messages are
  400.        recognized, to allow the program to properly operate the BBS under
  401.        just about any circumstances.
  402.  
  403.      > Seven PCBoard Mail Door types are directly supported in The Liberator,
  404.        and ProDoor ZIPM or regular PCBoard message downloads can be carried
  405.        out using The Liberator's Custom Commands (outlined below).  Carry out
  406.        message uploads, personal message downloads, repeat downloading,
  407.        regular message downloads, capture a SESSION.TXT file for use in your
  408.        offline reader -- all supported in Qmail v2 doors, Qmail v3 doors, and
  409.        MarkMail doors.  Pointer resets file uploads and current-session-only
  410.        scanning of ALL conferences can also be performed if using a Qmail v3
  411.        or v4 door.  Automatic packet maintenance is performed for all Mail
  412.        Door types.
  413.  
  414.      > Transfer files to/from BBS's in any of *six* ways!  Plain old PCBoard
  415.        file uploads and downloads are supported, for the very basic BBS. 
  416.        However, for maximum speed and efficiency, PCBoard batch uploads and
  417.        downloads (UB/DB) are supported, if available on your BBS, and ProDoor
  418.        batch uploads and downloads are also supported if a ProDoor is
  419.        available!  The Liberator will transfer as many files as you have time
  420.        for, and automatically remove files from your list when successfully
  421.        transferred.  If you don't have time to transfer a given file, it
  422.  
  423.  
  424.  
  425.  
  426.      The  L i b e r a t o r  v2.32                      Introduction - Page 2
  427.      
  428.      
  429.  
  430.        remains on your list for the next session.  Join a different
  431.        conference for each file, if necessary.  Specify multiple upload
  432.        and/or download passwords, if necessary.  Multiple-line upload
  433.        descriptions are also supported in ProDoor, and on PCBoard if avail-
  434.        able.
  435.  
  436.      > Use the MakeList command to automatically create a Download List from
  437.        the results of a user-defined command.  Set up any PCBoard or ProDoor
  438.        commands to send to the BBS, such as F)ile Directories, L)ocate, N)ew
  439.        files, or Z)ippy Scan commands, and MakeList will capture all files
  440.        found and place them on your Download List to be used in the same
  441.        session!  Send multiple commands in multiple conferences if desired,
  442.        and the correct conference will be joined before downloading the file. 
  443.        You can even manually edit the list, to remove specific files before
  444.        downloading.
  445.  
  446.      > Carry out ProBank time deposits and withdrawals if a ProBank door is
  447.        available on the BBS.  Set The Liberator to take some time out of the
  448.        ProBank when you need some extra time for a job.  Have it deposit all
  449.        your time at the end of a session, or configure how much time to put
  450.        in.  The Liberator will also check your available online time and
  451.        adjust your deposit to leave a specific amount of online time, if
  452.        desired.
  453.  
  454.      > If the above isn't enough, you can also set up multiple customized
  455.        commands to send to PCBoard and/or ProDoor, for the tasks that aren't
  456.        directly supported.  Use Custom Commands for ProDoor ZIPM mail
  457.        transfers, to capture mail from PCBoards without Mail Doors or a
  458.        ProDoor, or any other PCBoard/ProDoor tasks.  For more complicated
  459.        jobs you can even incorporate other SALT scripts into any session. 
  460.        Some useful example scripts are included, along with an easy-to-
  461.        understand SALT tutorial!
  462.  
  463.      > Interactive operation allows you to select jobs on the fly.  Customize
  464.        the level of interaction, and even carry out parts of the session
  465.        manually, if desired.  All of the jobs listed above can be turned
  466.        on/off, or set for interactive mode for any given session.
  467.  
  468.      > Any special logon or logoff can also be handled, and actually fully
  469.        incorporated into any given session.  Working iNet logon/logoff
  470.        scripts are included, but just about any type of logon or logoff can
  471.        be incorporated into any Liberator session with just a few keystrokes.
  472.  
  473.      > Set up a Master list of up to 100 sessions, using any combination of
  474.        the jobs outlined above in each session.  Dialing delay times can be
  475.        set and saved, and the entire Master list can be made to either repeat
  476.        itself, or even exit to DOS when complete.  When a connection is made,
  477.        the list is checked for other jobs to execute on the same BBS.  If any
  478.        are found, they will all be executed without disconnecting!  A dialing
  479.        queue is also used to give you the best chance of getting onto busy
  480.        PCBoards.  If a connection is not established within a user-defined
  481.        number of tries, the next job is started, and the current job is
  482.        marked to be tried again between all successful jobs.
  483.  
  484.  
  485.  
  486.  
  487.      The  L i b e r a t o r  v2.32                      Introduction - Page 3
  488.      
  489.      
  490.  
  491.      > Extra protection is built in for a situation when The Liberator can't
  492.        locate its position on the BBS.  The program actually reads the screen
  493.        just as you would, to determine where it is from any of eight key
  494.        positions on PCBoard and in the various doors.  Any job listed above
  495.        can be started from any of these eight locations.  If the current BBS
  496.        prompt is not recognized, ENTER is sent and it looks again for a
  497.        recognizable prompt, up to three times.  If a key prompt is not found
  498.        after three tries, the program notifies you that a recognizable prompt
  499.        could not be found and disconnects.  No more guessing as to what went
  500.        wrong with a session.
  501.  
  502.      > Logons are also equipped with a similar type of prompt recognition/-
  503.        recovery routine, but encompass all of the 16 logon prompts that are
  504.        tracked, and not just the eight key prompts.  In the logon, if none of
  505.        the 16 prompts are recognized within 10 seconds of establishing a
  506.        connection, ENTER will be sent.  This is also repeated in another 15
  507.        seconds, up to a total of three times if necessary.  This feature is
  508.        essential for connecting to PCBoards which need ENTER to be hit before
  509.        they start the logon.
  510.  
  511.      > And what feature listing would be complete without one of these: "Many
  512.        more features!"  There truly are dozens more, but I hope that was
  513.        enough to get you interested enough to carry on with the tutorial, to
  514.        see the many other features available.
  515.  
  516.      1.2  How To Use The Tutorial
  517.  
  518.       This document is introductory for the most part, mainly for first time
  519.       Liberator users or even first time BBS or PCBoard users.  It will take
  520.       you through the steps necessary to set up Telix, PCBoard, a Mail Door,
  521.       a Mail Reader, ProDoor and The Liberator itself, while you follow along
  522.       and actually get something done!  It was not designed to waste your
  523.       time, but to *save* you time since you participate and actually get
  524.       useful things done as we go along instead of possibly fumbling around
  525.       trying to figure it all out for yourself.
  526.  
  527.       The tutor is organized into lessons, and it is recommended that you at
  528.       least browse each lesson section to get some idea what you'll miss if
  529.       you skip it.  Even though you may be a Telix and/or PCBoard expert, you
  530.       may still want to quickly follow along with these setup sections, since
  531.       some of the information is specifically for setup of The Liberator.  Of
  532.       course, the more you know, the more you will be able to skip and the
  533.       faster the setup will be.
  534.  
  535.       Note that due to popular demand, a new document was provided in this
  536.       release of The Liberator, called MAIL.DOC (see your distribution
  537.       diskette or archive).  It is designed for the semi-experienced
  538.       Telix/PCBoard user, and only covers the steps necessary to automate
  539.       Mail Door runs.  If you want to get set up for automated mail runs
  540.       quickly, and are already familiar with Mail Door operation, please
  541.       refer to this document now, and refer back here later if you run into
  542.       trouble.
  543.  
  544.  
  545.  
  546.  
  547.      The  L i b e r a t o r  v2.32                   Getting Started - Page 4
  548.      
  549.      
  550.  
  551.                                  2. GETTING STARTED
  552.  
  553.  
  554.       If you haven't installed The Liberator yet, locate the program files
  555.       (INSTALL.EXE, *.SLC, .001, etc.), switch to the directory where they
  556.       are located (e.g. CD \TEMP, or A:), then enter GO to run the installa-
  557.       tion program.  The installation program will ask you what it needs to
  558.       know, then install and start The Liberator if all goes well.
  559.  
  560.       If you followed the installation program's instructions properly, you
  561.       should be looking at a prompt telling you to start reading the tutor
  562.       (congratulations... you actually did!) and to press any key.  Since you
  563.       are now exactly where you are supposed to be, please go ahead an press
  564.       a key to start The Liberator.  [Use the LIBERATE command from DOS or
  565.       <Alt-G>LIBERATE from Telix if not starting from the installation
  566.       program.  Then proceed to section 2.3.]
  567.  
  568.       GO.BAT will now display a few lines showing you how to start The
  569.       Liberator yourself.  Once you press a key, GO.BAT will simply enter the
  570.       command 'LIBERATE' for you.  In the future, enter this command yourself
  571.       to start The Liberator.
  572.  
  573.       If Telix starts properly but cannot find The Liberator, then you
  574.       possibly gave the wrong 'Script directory' to the installation program,
  575.       or don't have it defined properly in Telix.  If this happens, please
  576.       see the file TELIX.DOC that accompanied The Liberator, to define a
  577.       Script directory.  Once defined and saved, manually start the program
  578.       by typing <Alt-G> (hold down the <Alt> key and tap the 'G' key) then
  579.       enter LIBERATE.
  580.  
  581.      2.1  Liberator First Startup
  582.  
  583.       On the first startup, The Liberator automatically checks to ensure that
  584.       you have a Script Directory defined, then checks itself to see that all
  585.       its files are present in this directory, and that the size of each file
  586.       is what it should be.  If it aborts due to no defined Script Directory,
  587.       please see the file TELIX.DOC that accompanied The Liberator.  If it
  588.       aborts due to a missing file, or incorrect file size, check the
  589.       original disk/archive for the missing file, and re-install the program
  590.       if necessary.
  591.  
  592.       Your modem will also be checked to ensure that the 'carrier detect' is
  593.       not being forced on.  If you are notified that it is, please refer to
  594.       TELIX.DOC (the one that accompanied The Liberator) for instructions on
  595.       how to fix it, then manually restart the program using <Alt-G>LIBERATE.
  596.  
  597.       Next, if existing Command or Configuration Files from previous versions
  598.       are found, the program will convert them for you automatically. 
  599.       [Automation is the name of the game with The Liberator, and I hope you
  600.       like the word 'automatic', since you'll hear it, and experience it a
  601.       lot in this tutor...]
  602.  
  603.  
  604.  
  605.  
  606.      The  L i b e r a t o r  v2.32                   Getting Started - Page 5
  607.      
  608.      
  609.  
  610.       After any conversion, you are then taken (automatically) to the main
  611.       Configuration screen, but this screen is mainly displayed for users who
  612.       are updating from a previous version of The Liberator and know what the
  613.       options mean.  New users may also realize what some options are for,
  614.       but for now hit <Esc>.  You can come back to this screen later if you
  615.       want by referring to the "Liberator Configuration" section below for
  616.       instructions.
  617.  
  618.      2.2  Registration Reminder Screen
  619.  
  620.       The next thing you will see is the opening title screen, reminding you
  621.       that you are using an unregistered evaluation copy of the Liberator. 
  622.       The screen displays the number of times the program has been used, but
  623.       please note that The Liberator keeps track of this number for your
  624.       interest only.  The program does not expire at a certain number, as it
  625.       is felt that a simple reminder is all that is necessary.  Many people
  626.       actually forget that they are only using an evaluation copy, and
  627.       instead of crippling the program, I feel this screen is an adequate
  628.       reminder.  If you decide to register, you will receive a 'key' file
  629.       which causes the program to bypass this reminder.  The usual Telix
  630.       screen colors are also used if a key file is present, giving the
  631.       program a very integrated look.  See the registration form near the
  632.       beginning of this document for more information on registering.
  633.  
  634.      2.3  BBS Configuration Files
  635.  
  636.       From the title screen, on the very first startup, you are automatically
  637.       taken to create new Command and Configuration Files, and should now be
  638.       looking at screen 1 of your first BBS Configuration.  If this is not
  639.       your first startup, please select 'Create' from the main menu, by
  640.       entering a 'C'.
  641.  
  642.       If you are prompted for a Configuration to use, hit the <Enter> key to
  643.       Create a new one.  BBS Configurations (Configuration Files) are used to
  644.       hold information regarding one specific PCBoard BBS.  Each PCBoard BBS
  645.       that you intend to use The Liberator with will require at least one BBS
  646.       Configuration.  As you can see, it holds information about you such as
  647.       your name, and lots of information about the BBS such as doors,
  648.       protocols, etc.  There are four Configuration screens altogether,
  649.       (screen 4 is only available if a Mail Door is defined), and we'll cover
  650.       all the configuration entries later.  If none of it makes any sense to
  651.       you now, it will by the time we go to set up a full Configuration
  652.       later.  For now, we'll just create the simplest one possible.
  653.  
  654.       Each item on the screen can be changed by selecting the number
  655.       displayed in the left column.  Note that the numeric keypad sends
  656.       different key codes, and is not presently supported.  The numbers on
  657.       the top row of your keyboard must be used to enter digits.  Type a '1'
  658.       now, and hit <Enter>.
  659.  
  660.  
  661.  
  662.  
  663.      The  L i b e r a t o r  v2.32                   Getting Started - Page 6
  664.      
  665.      
  666.  
  667.      2.4  Editing Screen Entries
  668.  
  669.       When an entry is selected, it will be displayed in reverse video, right
  670.       to the maximum limit of the item selected.  To change the contents,
  671.       simply type over existing characters, or use any of the following keys
  672.       for editing:
  673.  
  674.       <Ctrl-End>    Hold down the <Ctrl> key and tap the <End> key to remove
  675.                     all characters from the cursor position to the end of the
  676.                     entry.  This can be used to clear an entry, or remove a
  677.                     number of characters quickly.
  678.       <Ins>         Toggles insert/typeover mode.  Each item starts in
  679.                     typeover mode when selected.  Press <Ins> once to change
  680.                     to insert mode (characters are inserted at the cursor
  681.                     position until the entry is filled). Press <Ins> once
  682.                     more to change back to typeover mode.
  683.       <Home>        Moves the cursor to the first character of the item.
  684.       <End>         Moves the cursor to the position following the last
  685.                     character of the item.
  686.       <Left arrow>  Moves the cursor one position to the left.
  687.       <Right arrow> Moves the cursor one position to the right.
  688.  
  689.       <Alt-F>       Hold down the <Alt> key and tap 'F' at any time (even
  690.                     when editing an entry) to call up the Telix DOS functions
  691.                     menu, which allows various DOS tasks to be carried out.
  692.       <Alt-J>       You may also enter <Alt-J> (Jump to DOS) at any point in
  693.                     The Liberator to temporarily exit to DOS.  Type EXIT at
  694.                     the DOS prompt when you are ready to return to The
  695.                     Liberator, and everything will be just as it was.
  696.  
  697.       To accept an item as displayed, hit the <Enter> key.  To abort any
  698.       changes and return the item to its previous value, hit the <Esc> key.
  699.  
  700.       Now that you know how to change the entry, 'Name used on PCBoard' is
  701.       exactly as it appears, and the name entered here will be sent to the
  702.       BBS in the logon sequence.  Think of a local PCBoard, and enter the
  703.       name you normally enter in the logon (if you haven't called any
  704.       PCBoards yet, enter your own name).  Before you hit <Enter>, I would
  705.       also like to demonstrate two new features in The Liberator v2.3:
  706.  
  707.       Hit <Alt-F> now and you will see the Telix DOS functions menu pop up,
  708.       just as in Telix.  This menu can be called up at any time in The
  709.       Liberator to allow common DOS tasks to be carried out.  You might use
  710.       it to browse a text file such as this document, in the middle of
  711.       editing an entry, or just when something pops into your mind that has
  712.       to be taken care of right away (hit <Esc> to exit the menu).  As well,
  713.       <Alt-J> will allow you to temporarily jump (shell) to DOS to carry out
  714.       some task, or even run another program.  Once the DOS task is carried
  715.       out, type EXIT at the DOS prompt and you will return exactly where you
  716.       were when you hit <Alt-J>.  Hit <Enter> now, to enter your name.
  717.  
  718.       Item 2 'Telix Directory Numbers to Dial' is normally where you place
  719.       actual dialing directory numbers, but you can also leave it blank to
  720.  
  721.  
  722.  
  723.  
  724.      The  L i b e r a t o r  v2.32                   Getting Started - Page 7
  725.      
  726.      
  727.  
  728.       select the entries manually.  Leave it blank for this Configuration,
  729.       and we'll select the BBS from the directory later.
  730.  
  731.       Believe it or not, this Configuration may now be usable simply after
  732.       entering your name, and we'll test it out in a second.  Note beside the
  733.       cursor at the bottom of the screen the reminder 'Enter = Save', and
  734.       since we're finished for now, hit <Enter> to do just that.  A box will
  735.       pop up prompting you for a name to save the file under.  Just call it
  736.       PCBOARD, since it isn't set up for any specific BBS.  The information
  737.       will then be saved in a file called PCBOARD.CFG, which will be created
  738.       in your Script directory.  If you use the main menu 'Tools' option,
  739.       explained below, you may have The Liberator save these Configurations
  740.       in another directory if desired.
  741.  
  742.      2.5  Command Files
  743.  
  744.       The thing about the Configuration Files though, is that they don't
  745.       actually specify what you want done on a BBS... they simply hold
  746.       configuration information which gives The Liberator information about
  747.       the BBS.  To define the actual jobs to carry out, we must set up a
  748.       'Command File', and you should be looking at the Command File Editor
  749.       now, since you are automatically taken there after creating a Con-
  750.       figuration.
  751.  
  752.       Note that the name PCBOARD has been placed in the 'Configuration File'
  753.       item for you.  If desired, many Command Files, each doing different
  754.       tasks, can be set up to use the PCBOARD Configuration we just saved.
  755.  
  756.       'Capture File' is the drive, path, and filename used to capture the
  757.       session.  The default name given is made up by extracting the drive/-
  758.       directory from your current Telix capture file, then adding the name of
  759.       the BBS Configuration and the extension .CAP.  You may change it to any
  760.       other name by selecting/editing the item, if desired.
  761.  
  762.       Some items will display <N/A> (not applicable), since these items
  763.       require doors #'s to be defined in the Configuration before they are
  764.       usable, and we did not define any doors in PCBOARD.CFG.
  765.       
  766.       Skipping to the last item on the screen, 'Disconnect' controls whether
  767.       to log off when the defined jobs complete, or to stay connected (or
  768.       even to disconnect, then exit to DOS).  In this case, since we don't
  769.       have any jobs defined, we will change Disconnect to 'No', which will
  770.       cause the The Liberator only to open the capture file, logon, then
  771.       leave you at the main board prompt.  Sort of an enhanced PCBOARD.SLT. 
  772.       Select 'Disconnect' (14) and enter 'n' for No disconnect.
  773.  
  774.       The other Command File items are discussed later.  For now, we need
  775.       some information from a PCBoard itself, so please hit <Enter> (Enter =
  776.       Save), and enter the name PCBLOGON to save the file.  The file will be
  777.       created in your Script directory under the name PCBLOGON.CMD.  Command
  778.       Files may also be created in another directory using the Tools option,
  779.       explained later.
  780.  
  781.  
  782.  
  783.  
  784.      The  L i b e r a t o r  v2.32                   Getting Started - Page 8
  785.      
  786.      
  787.  
  788.      2.6  The Command File Manager
  789.  
  790.       You should then be taken to the main menu, or 'Command File Manager'. 
  791.       You will see that entry 0 holds the MASTER, and you should also see the
  792.       name PCBLOGON in one of the other entries, which is the Command File we
  793.       just created.  There should also be a few others filled in, as a couple
  794.       of Command Files are included with The Liberator.  These are mainly for
  795.       demonstration of the interactive features of Command Files.
  796.  
  797.       The MASTER refers to a special file (maintained with Add/Remove) that
  798.       is used to run multiple sessions on one or more PCBoards, one after the
  799.       other without intervention from you.  The word MASTER is displayed in
  800.       entry 0 whether you have created this Master list or not, but disregard
  801.       it for now.  When you're ready to set up a Master to run multiple
  802.       sessions, please refer to the section 'Using the Master'.
  803.  
  804.      2.7  Print a BBS Configuration Form
  805.  
  806.       Next, we must get set up to call a PCBoard.  The Telix dialing
  807.       directory itself may need setting up, and we'll check this in a second. 
  808.       When we do get connected, you will have to take some information down,
  809.       such as PCBoard door numbers and 'protocols'.  If your BBS has a Mail
  810.       Door, it will also need setting up if you have never used it.  How to
  811.       do these things is all covered below, and is fairly simple, so don't
  812.       worry about a lot of work.  To help you keep track of the information
  813.       we need, you should print out the file BBS-CFG.FRM that accompanied The
  814.       Liberator, if you have a printer connected.  Type <Alt-J> from the
  815.       Command File Manager (jump to DOS), change to the directory where the
  816.       file is located if necessary, then setup your printer and type COPY
  817.       BBS-CFG.FRM PRN.  When the form is printed out, type EXIT to return to
  818.       The Liberator.  If you do not have a printer, a blank piece of paper
  819.       will do.
  820.  
  821.       Next, start the PCBLOGON Command File we created by typing the number
  822.       beside it, and hitting <Enter>.  A screen should appear, which shows
  823.       what is about to be carried out, and only the Capture File and Discon-
  824.       nect options should be activated (along with a Dial Starting Time of
  825.       'Now').  You are given 10 seconds to look the screen over and abort the
  826.       file (you can increase/reduce or remove the delay entirely using the
  827.       'Tools' option from the main menu.  Many of these details will be
  828.       covered after we get the BBS set up).  Hit a key or wait 10 seconds for
  829.       dialing to start.
  830.  
  831.      2.8  Dialing Directory Setup
  832.  
  833.       Since we didn't define any directory entries in the BBS Configuration,
  834.       instead of dialing immediately, the Telix dialing directory is
  835.       displayed to allow you to select one or more entries.  However, before
  836.       we can actually place the call to a PCBoard, we must define the proper
  837.       telephone numbers and some other information in the Telix dialing
  838.       directory.  Even if you have entries set up, please follow along here,
  839.       since there are specific items The Liberator needs set up properly.
  840.  
  841.  
  842.  
  843.  
  844.      The  L i b e r a t o r  v2.32                   Getting Started - Page 9
  845.      
  846.      
  847.  
  848.       To add a new directory entry, get the phone number of a PCBoard handy
  849.       and move the highlight bar to a blank directory entry (or select 'Add'
  850.       to create a blank, then hit <End> and move to the blank entry).  Once
  851.       on a blank entry, select 'Edit'.
  852.  
  853.       Enter a description of the PCBoard in 'Name' (e.g. Joe's PCBoard), and
  854.       hit <Enter>, then enter the BBS's telephone number in the 'Phone
  855.       number' item.  All the items down to 'Linked script' should be fine at
  856.       their defaults, so move down by hitting <Enter> a few times, then enter
  857.       "PCBoard" (without the quotes) in Linked script.  A linked script is
  858.       automatically executed if you make a manual call (without The Liber-
  859.       ator), and the defined script will be run to automatically log you on. 
  860.       You must edit (include your name) and compile PCBOARD.SLT before using
  861.       it, so later please see the instructions in this file if you haven't
  862.       done so.  It is recommended you use the PCBOARD.SLT that accompanied
  863.       The Liberator, since it performs a more complete logon (The Liberator
  864.       has its own logon routines though, and normally doesn't require this
  865.       file).  Set it up and compile it whenever you get a chance.
  866.  
  867.       *IMPORTANT*:  Even if you prefer not to use PCBOARD.SLT as a Linked
  868.       Script, you must enter something (any character) in the 'Linked script'
  869.       item or Telix will pause after connecting and The Liberator will miss
  870.       the opening logon prompt.
  871.  
  872.       The 'Default terminal' should be set to ANSI-BBS and I recommend you
  873.       use Zmodem as your default protocol, though it is up to you. 
  874.  
  875.      2.9  What are Protocols?
  876.  
  877.       [If you're familiar with protocols, skip this section.]  Protocols are
  878.       used when transferring computer files (programs, etc.) to and from the
  879.       BBS, and you might think of them as a language.  Let's say 1k-Xmodem is
  880.       Spanish, Ymodem is Japanese, Zmodem French, etc.  As with people, the
  881.       actual language being spoken is not really important as long as both
  882.       people are using, and understand the language agreed upon.
  883.  
  884.       Likewise when you transfer a file, both Telix and the PCBoard at the
  885.       other end must be speaking the same language, or using the same
  886.       protocol, when transferring programs back and forth.  Like languages,
  887.       some protocols are also more efficient than others.
  888.  
  889.       Zmodem is an efficient and reliable protocol to use, but remember that
  890.       it must be available at the BBS before you can use it.  Ymodem (Batch)
  891.       is also a good choice, then 1k-Xmodem if all else fails.  If you have
  892.       an error-correcting modem (MNP, etc.) you may also use the -G protocols
  893.       for some extra speed (Ymodem-g, G-1k-Xmodem), though I find transfers
  894.       often abort using these protocols, with or without The Liberator.
  895.  
  896.      2.10  What are Batch Protocols?
  897.  
  898.       Some protocols also have the ability to transfer files a bunch at a
  899.       time (a 'batch') while others can only send one file at a time.  Batch
  900.       protocols normally allow 'wildcards' (as in DOS, * and ?), and/or
  901.  
  902.  
  903.  
  904.  
  905.      The  L i b e r a t o r  v2.32                  Getting Started - Page 10
  906.      
  907.      
  908.  
  909.       several filenames to be specified, separated by spaces.  Once a batch
  910.       transfer starts, the Telix transfer window will stay displayed on the
  911.       screen continuously while one file is sent after the other.  Non batch
  912.       protocols allow only one file to be specified at a time, which is
  913.       slower.  The most common batch protocol is Zmodem, Ymodem (Batch) is
  914.       another, as well as Ymodem-g.  Xmodem is not batch oriented, nor is 1k-
  915.       Xmodem or G-1k-Xmodem.  The Liberator will take advantage of batch
  916.       transfers in ProDoor, and on PCBoard if available.
  917.  
  918.      2.11  Enter Your Password
  919.  
  920.       Moving along, the rest of the directory entries up to 'Password' should
  921.       be fine at their default values, so hit <Enter> a few times to move
  922.       down.  In the 'Password' entry, <Enter> a password to use on the BBS
  923.       and hit <Enter> twice more to save the entry.
  924.       *IMPORTANT*: You MUST enter your password in ALL entries you intend to
  925.       use The Liberator with, as this is where The Liberator looks for your
  926.       password.  If no password is defined in an entry you connect to using
  927.       The Liberator, the program will abort and disconnect.
  928.  
  929.      2.12  Dial the BBS
  930.  
  931.       Now that you have your entries set up properly, to carry out dialing,
  932.       highlight the proper entry, or mark all appropriate entries with the
  933.       space bar (making sure they are all PCBoard BBS's), then select 'Dial'
  934.       on the bottom menu bar.  Once connected, control is returned to The
  935.       Liberator where it will carry out the logon (The Liberator always
  936.       disables any 'Linked scripts', such as the 'PCBoard' linked script
  937.       discussed above).
  938.  
  939.       If you are logging on for the first time, you will have to abort the
  940.       Command File by hitting <Esc>, then enter some information to get
  941.       signed up on the PCBoard.  (Select "C)ontinue to logon as a new user"
  942.       on the BBS by entering a 'C', then answer any questions.  When prompted
  943.       for a password, make sure you enter the same one defined in your
  944.       dialing directory.)  Otherwise, The Liberator will attempt to log on,
  945.       and should only run into problems if your modem is not set up properly,
  946.       or the Sysop [BBS System Operator] is using an old version of PCBoard,
  947.       or has changed the format of some logon questions.
  948.  
  949.       If the logon does not take place at all (you see no text within 10
  950.       seconds or so), then most likely your modem and/or Telix is not set up
  951.       properly and you should refer to your modem documentation, and the
  952.       Telix documentation.  Common problems include not having 'Echo' turned
  953.       on in Telix, or on your modem, or having it turned on in both (double
  954.       characters), or having the wrong baud rate set (you must use a baud
  955.       rate that both your modem and the PCBoard support... start at 300 and
  956.       work your way up if in doubt).  The comm. parameters should also be set
  957.       in the Telix dialing directory to Parity None, Data bits 8, Stop bits
  958.       1.
  959.  
  960.       If the BBS is using an old version of PCBoard, or has changed the
  961.       format of some questions (prompts) PCBoard asks in the logon, The
  962.  
  963.  
  964.  
  965.  
  966.      The  L i b e r a t o r  v2.32                  Getting Started - Page 11
  967.      
  968.      
  969.  
  970.       Liberator may not recognize one or more of the logon questions.  If the
  971.       program cannot find a recognizable prompt within 10 seconds of a
  972.       connection, it will send an <Enter>, then look again for 10 seconds,
  973.       then send a few Ctrl-X's and Ctrl-K's to attempt to get the board's
  974.       attention (aborts any bulletins, etc.), and tries again.  If after
  975.       three tries a recognizable prompt is still not found, the program will
  976.       notify you and abort.
  977.  
  978.       If this happens, abort The Liberator by hitting <Esc>, and logon
  979.       manually.  Someone may have uploaded a working Configuration for this
  980.       BBS (we'll check in a minute), so you may not have to worry about
  981.       setting up all the prompts yourself.  If a working Configuration is not
  982.       found, the section 'Configuring Prompts' will give you some pointers. 
  983.       However, the main thing now is to get the PCBoard set up for use. 
  984.       Configure any prompts later, after we disconnet, if necessary.
  985.  
  986.  
  987.  
  988.  
  989.      The  L i b e r a t o r  v2.32                    PCBoard Setup - Page 12
  990.      
  991.      
  992.  
  993.                                  3.  PCBOARD SETUP
  994.  
  995.  
  996.      3.1  Checking For Batch Transfer Support
  997.  
  998.       As mentioned above, some protocols allow files to be transferred in a
  999.       'batch' or several at a time, one after the other.  The PCBoard UB/DB
  1000.       commands are used to enter several filenames (a batch) before the
  1001.       transfer starts.  Once all the filenames are entered, then the actual
  1002.       transfer starts and all files are sent one after the other without
  1003.       having to close the download window, and go back to the main menu to
  1004.       enter the next filename.
  1005.  
  1006.       If this doesn't make any sense now, you'll see what I mean when you go
  1007.       to download some files.  Suffice to say it is a faster way to transfer
  1008.       files than the conventional PCBoard method of entering one name,
  1009.       transferring the file, going back to the main menu, entering the next
  1010.       filename, transferring the file, etc.  On a test download of 10 small
  1011.       files, performing the transfer in non-batch mode took 5 minutes, while
  1012.       the same transfers in batch mode took just over 3 minutes.  Needless to
  1013.       say, if you are transferring hundreds of files each week, the savings
  1014.       in online time and/or long-distance fees could be substantial by taking
  1015.       advantage of batch transfers.
  1016.  
  1017.       The Liberator supports every type of file transfer PCBoard is capable
  1018.       of.  Regular non-batch transfers are of course supported, but also both
  1019.       the PCBoard UB (Upload Batch) and DB (Download Batch) commands are
  1020.       supported, if available, and the program also allows batch uploads and
  1021.       downloads in ProDoor if a ProDoor is available.
  1022.  
  1023.       To make use of PCBoard batch transfers, you must first check to ensure
  1024.       that your BBS supports them.  The UB/DB commands were relatively new at
  1025.       release of The Liberator v2.3, and your Sysop may not have upgraded to
  1026.       a new version of PCBoard yet.
  1027.  
  1028.      3.2  Checking the PCBoard Version Number
  1029.  
  1030.       An easy way to see if the UB/DB commands are available on your BBS, is
  1031.       to check the version number of PCBoard that your Sysop is using.  To do
  1032.       this, first press a key to get rid of The Liberator's 'Command File
  1033.       Complete' window.  (Note that if you were not at your computer, The
  1034.       Liberator would have sounded a pager every ten seconds until you
  1035.       returned and pressed a key.)
  1036.  
  1037.       Now, enter the I)nitial Welcome command at the PCBoard 'Command?'
  1038.       prompt by entering an 'I'.  Near the first line, you should see
  1039.       something similar to this:
  1040.  
  1041.       PCBoard (R) - Version 14.5/U
  1042.  
  1043.       All we need from this is the 14.5 (could also be 14.2, 15.0, etc).  You
  1044.       will later enter this version number in a Liberator Configuration, and
  1045.       The Liberator will then know if it is possible to perform file
  1046.  
  1047.  
  1048.  
  1049.  
  1050.      The  L i b e r a t o r  v2.32                    PCBoard Setup - Page 13
  1051.      
  1052.      
  1053.  
  1054.       transfers in batch mode.  If the BBS is using 14.5 or greater, both the
  1055.       UB and DB commands are available.  As well, multiple-line upload
  1056.       descriptions are supported by PCBoard 14.5 or greater, and The
  1057.       Liberator allows you to enter extended descriptions when available.
  1058.       Multi-line upload descriptions are also supported in ProDoor.  PCBoard
  1059.       14.2 supports the DB command, but not the UB command, so The Liberator
  1060.       will not make use of batch transfers here.  Batch transfers use
  1061.       different prompts than regular transfers, and The Liberator cannot
  1062.       handle both PCBoard methods at once.  See the 'File Transfers' section
  1063.       later, for further details on uploading or downloading files.  For now,
  1064.       simply make note of the PCBoard version on the BBS Configuration Form,
  1065.       or on a piece of paper.
  1066.  
  1067.       If the BBS is displaying the 'More' prompt, enter an 'N' for No more,
  1068.       and you will return to the PCBoard main menu.
  1069.  
  1070.      3.3  Setting Up Protocols
  1071.  
  1072.       Next, select T)rans. Protocol to view the available PCBoard protocols. 
  1073.       Then type <Alt-S> to view the Telix protocol menu and find a protocol
  1074.       that both Telix and the PCBoard have available.  Make a note of the
  1075.       letter used on the Telix protocol menu to select the protocol you
  1076.       prefer, then hit <Esc>.  Next, enter whichever letter is used on
  1077.       PCBoard to signify the same protocol.  This will be saved by PCBoard as
  1078.       your 'default' protocol.
  1079.  
  1080.       Note that with some error-correcting modems, the 'G' protocols (Ymodem-
  1081.       g, G-1k-Xmodem) are not reliable for uploading, so with The Liberator
  1082.       you can select a separate protocol for uploading, while using the
  1083.       faster 'G' protocol for downloading.  If this is desired, SET YOUR
  1084.       DEFAULT PROTOCOL ON PCBOARD TO 'N)one', take note of the actual letter
  1085.       used to select the non-'G' protocol you desire (e.g. 'Z' for Zmodem),
  1086.       as well as the letter used to select the 'G' protocol (e.g. E for
  1087.       Ymodem-g), on both the Telix protocol menu and the PCBoard protocol
  1088.       menu, then enter the information on a piece of paper or the BBS
  1089.       Configuration form.  The Liberator will use these letters later to
  1090.       select the proper protocols both from Telix, and from the PCBoard.  If
  1091.       you are only using one protocol for uploading and downloading, you can
  1092.       ignore the PCBoard letter used to select it, as long as it is set as
  1093.       your default protocol.
  1094.  
  1095.      3.4  Searching For Liberator Configurations
  1096.  
  1097.       Next, from the PCBoard main menu, type "Z Liberat A" (no quotes, and no
  1098.       'or' in Liberat in case it is misspelled 'Liberater') and hit <Enter>
  1099.       to perform a Z)ippy scan for Liberator Configurations.  A helpful
  1100.       Liberator user may have uploaded a working Configuration for this BBS,
  1101.       which will save us a bit of work (depending on the level of Sysop-
  1102.       customization on the BBS, it may save also save you some headaches
  1103.       trying to get the proper prompts).  The description should say 'Liber-
  1104.       ator Configuration for <BBS>' or something similar.  It doesn't matter
  1105.       what version of The Liberator the Configuration is for, since all older
  1106.       versions of these files can be automatically converted, if necessary.
  1107.  
  1108.  
  1109.  
  1110.  
  1111.      The  L i b e r a t o r  v2.32                    PCBoard Setup - Page 14
  1112.      
  1113.      
  1114.  
  1115.      3.5  Joining Conferences
  1116.  
  1117.       If you don't find anything, try entering a 'J' to see the conference
  1118.       menu (it may be longer than one screen; hit <Enter> after each screen-
  1119.       full).  You may need to J)oin a specific conference to get at the IBM
  1120.       or Communications files, etc.  Enter the appropriate conference number,
  1121.       then resend the Z)ippy Scan command, if necessary.  You may also want
  1122.       to write down the conference number and have The Liberator automatical-
  1123.       ly join this conference at startup.  If you had to join now to get a
  1124.       file, chances are you'll have to do the same later, so you might as
  1125.       well have The Liberator do it for you, so you won't forget.  Note that
  1126.       some conferences also require you to OPEN ProDoor before joining them. 
  1127.       Type OPEN and enter the ProDoor number if this is the case.
  1128.  
  1129.       The Zippy scan should also reveal The Liberator v2.32 itself, (LIB232.-
  1130.       ZIP) but if it doesn't it would be appreciated if you made a note to
  1131.       upload it to this BBS after we get The Liberator set up.  An Upload
  1132.       List has been provided to allow you to automatically upload The Liber-
  1133.       ator.  I.e. the program uploads itself!  Software such as The Liberator
  1134.       relies on users like yourself for distribution.
  1135.  
  1136.       If you didn't find a Configuration, don't despair.  They are normally
  1137.       very easy to set up and we'll go through a full setup below.  If the
  1138.       Z)ippy scan did turn one up, enter the PCBoard command "D <filename.-
  1139.       ext>", where <filename.ext> is the filename of the Configuration (e.g.
  1140.       BBSCFG.ZIP), then hit <Enter>.  If PCBoard prompts you for filename 2,
  1141.       hit <Enter> again, twice.  Then, hit <Alt-R> (receive; you can also use
  1142.       <PgDn>) to receive the file, and select the proper protocol from the
  1143.       Telix menu.  The download should only take a few seconds, and for now,
  1144.       we'll just leave the Configuration in your Download Directory, for use
  1145.       later when we set up The Liberator further.  Once you get a BBS
  1146.       Configuration working for the BBS, it would also be appreciated if you
  1147.       could make a note to upload it for others to make use of.  Please try
  1148.       to test all features before uploading it though.  Feel free to include
  1149.       your name for credit.
  1150.  
  1151.      3.6  Turning Expert Mode On
  1152.  
  1153.       Since The Liberator does not make use of PCBoard menus, you can also
  1154.       turn X)pert mode on by typing 'X'.  The PCBoard main menu will not be
  1155.       displayed when expert mode is on, which will speed up operations a
  1156.       little.  If you logon manually and get lost (which you may never have
  1157.       to do, with The Liberator at your disposal) you can simply type 'X'
  1158.       again to turn eXpert mode off.
  1159.  
  1160.      3.7  Viewing the available DOORS
  1161.  
  1162.       Now, type OPEN and hit <Enter> to get a listing of doors available on
  1163.       the BBS.  We are interested in Qmail v2/v3/v4, MarkMail, MegaMail,
  1164.       NetMmail, PCRelay, ProDoor, and/or ProBank, so please fill in these
  1165.       door #'s on the BBS Configuration form or a piece of paper, if found
  1166.       (only ONE Mail Door 'type' is supported per Configuration... if the
  1167.       board has multiple types, choose the one you like best).  If the board
  1168.  
  1169.  
  1170.  
  1171.  
  1172.      The  L i b e r a t o r  v2.32                    PCBoard Setup - Page 15
  1173.      
  1174.      
  1175.  
  1176.       supports door NAMES you may also use the names if desired (e.g. you
  1177.       enter QMAIL4, instead of the number 1, etc.)  If you cannot locate a
  1178.       door on the menu, but you are sure it exists, you may have to J)oin a
  1179.       specific conference first.  Exit the door menu by hitting <Enter>, then
  1180.       type 'J' and hit <Enter> to get a list of conferences, and join the
  1181.       most probable one then type OPEN again.  Keep J)oining conferences
  1182.       until you find the correct one (or try reading some of the B)ulletins,
  1183.       or leave a C)omment to the Sysop asking where it is, if all else
  1184.       fails), then make note of the conference for use setting up a BBS
  1185.       Configuration later.
  1186.  
  1187.       If no appropriate doors were found, hit <Enter> at the door menu to
  1188.       return to the main prompt, then type 'G' for G)oodbye to log off and
  1189.       proceed to the next section.  You can still make good use of The
  1190.       Liberator even if no doors at all are available.  If you located a
  1191.       ProDoor, and are using PCBoard v14.2 or less, please enter its number
  1192.       to OPEN it.  If only a Mail Door was located, skip to the 'Mail Door
  1193.       Setup' section below.
  1194.  
  1195.       PRODOOR NOTE:  Since the release of PCBoard v14.5, ProDoor's use has
  1196.       become somewhat redundant.  If you are setting up for a PCBoard v14.5
  1197.       (or greater) board, I recommend you leave ProDoor undefined in your
  1198.       Liberator Configuration, and simply enable PCBoard batch transfers. 
  1199.       Most of the 'extras' ProDoor had to offer are now duplicated in PCBoard
  1200.       14.5, so there isn't much sense wasting time opening the ProDoor to
  1201.       perform the same tasks.  However, if setting up for an older PCBoard
  1202.       (14.2 or less, or a ProLogon board), proceed with ProDoor set up.
  1203.  
  1204.      3.8  ProDoor Setup
  1205.  
  1206.       Once at the ProDoor main prompt, select 'D' and hit <Enter> to view the
  1207.       protocol menu, then type <Alt-S> to display the Telix protocol menu. 
  1208.       ProDoor frequently has extra protocols that are not available on
  1209.       PCBoard.  Find a protocol that both Telix and ProDoor support, then
  1210.       take note of the Telix protocol menu letter for the protocol you prefer
  1211.       and hit <Esc> (if using separate upload/download protocols, make note
  1212.       of both letters).  Then take note of the ProDoor menu letter used to
  1213.       signify the same protocol (again, if you wish to use separate protocols
  1214.       for uploading and downloading, please take note of both letters). 
  1215.       Enter the information on the BBS Configuration form, then hit <Enter> a
  1216.       couple of times to abort the ProDoor download.
  1217.  
  1218.      3.9  Mail Door Setup
  1219.  
  1220.       If the BBS has a Mail Door (Qmail/MarkMail only), OPEN the door by
  1221.       selecting its number from the door menu, and we'll go set it up for
  1222.       use.  If you are not looking at the door menu, type OPEN then hit
  1223.       <Enter>, and enter the appropriate number.  If using a MegaMail-type
  1224.       door, the set up in this section does not apply.  Please see your
  1225.       Offline Reader documentation for information on setting up these doors.
  1226.  
  1227.       Setting up a Mail Door is very easy, and in my opinion is much easier
  1228.       than learning the standard online way of messaging.  These doors
  1229.  
  1230.  
  1231.  
  1232.  
  1233.      The  L i b e r a t o r  v2.32                    PCBoard Setup - Page 16
  1234.      
  1235.      
  1236.  
  1237.       collect new messages on all the subjects (conferences) you're inter-
  1238.       ested in, then they compress all the messages found, usually in Phil
  1239.       Katz's ZIP format.  You then receive (download) a file which you can
  1240.       browse offline at your leisure, using a special reader program.  Not
  1241.       only does this save your limited online time, and possibly long-
  1242.       distance fees, but it's also more relaxing and allows you to be more
  1243.       thoughtful about your replies since there is no need to rush.
  1244.  
  1245.       If opening a Qmail door, once the door opens, take note of the Qmail
  1246.       major version number (for MarkMail, simply make note that a MarkMail
  1247.       door is being used).  The Qmail v2.xx, v3.xx, v4.xx doors operate quite
  1248.       differently and the major version # must be specified in The Liberator.
  1249.  
  1250.       The basic steps to setting up these doors is to select C)onfigure, then
  1251.       a) select the conferences (each conference covers a different subject)
  1252.       you are interested in, b) reset your 'last message read' pointers in
  1253.       each conference to the last 50 or 100 messages, so that you don't get
  1254.       thousands of old messages (e.g. if the 'high message' pointer is at
  1255.       500, set your 'last message read' pointer to 400 or 450... do this for
  1256.       each conference), and c) select a default protocol.  That's about all
  1257.       there is to it.  Most Mail Doors will even take you to the proper menus
  1258.       automatically, the first time you use them.
  1259.  
  1260.       There are other optional items that you may want to change, such as
  1261.       getting a listing of new files/bulletins in each packet, etc.  Take a
  1262.       look at the Configuration menu and configure the door as you like (if
  1263.       you don't see a menu, turn expert mode off by entering an 'X').  In 
  1264.       Qmail v3/4 doors, some extra options are available by entering OPT
  1265.       (enter a question mark to view the OPTions, then type a number to
  1266.       toggle it ON or OFF as you like).
  1267.  
  1268.       NOTE:  One important OPTion in the Qmail v3/4 doors is the 'Clear the
  1269.       keyboard input buffer' item, which must be turned OFF (do not clear the
  1270.       buffer).  If left ON, The Liberator's commands to the door may be
  1271.       erased, since it sends them very quickly, usually before the entire
  1272.       prompt has even been displayed.
  1273.  
  1274.       If you wish to use separate protocols for uploading and downloading,
  1275.       you must be using a Qmail v3/4 door. In this case, take note of the
  1276.       letters used on the door's protocol menu, to select the protocols you
  1277.       desire, and fill the information in on the BBS Configuration form.  If
  1278.       you are using a Qmail v2, MarkMail or other door, you must set a
  1279.       'default' protocol, and use the same protocol for both uploads and
  1280.       downloads.
  1281.  
  1282.       The Liberator also needs to know the official Packet ID of the BBS, in
  1283.       order to locate and maintain mail packets.  You can find out the Packet
  1284.       ID now by selecting 'D' from the main door menu to Download a mail
  1285.       packet (in Qmail v3/4 doors, first select 'Q)uit' to get out of the
  1286.       Configuration menu, and back to the main door menu).  The door will
  1287.       then start collecting messages from all the conferences you selected,
  1288.       and will display a screen of what it found.  It then asks if you want
  1289.       the packet, to which you reply 'Y' (yes).  The door will then start to
  1290.  
  1291.  
  1292.  
  1293.  
  1294.      The  L i b e r a t o r  v2.32                    PCBoard Setup - Page 17
  1295.      
  1296.      
  1297.  
  1298.       compress the packet, which may take a minute or two, and will prompt
  1299.       you to start your download when the packet is ready.
  1300.  
  1301.       Of course, if you are not using auto-Zmodem hit <Alt-R> (receive) and
  1302.       select the proper protocol when the door prompts you to start your
  1303.       download (later, The Liberator will take care of all this for you).  In
  1304.       the Telix download window you will see a file called SOMETHING.QWK (QWK
  1305.       for Qwik, since the original door used to be called the QwikMail
  1306.       Door... since changed to Qmail Door.  The QWK extension is just a
  1307.       renamed ZIP or ARC, etc).  The SOMETHING part of the filename is what
  1308.       we're interested in, since this is the Packet ID.
  1309.  
  1310.  
  1311.  
  1312.  
  1313.      The  L i b e r a t o r  v2.32                Mail Reader Setup - Page 18
  1314.      
  1315.      
  1316.  
  1317.                                4.  MAIL READER SETUP
  1318.  
  1319.  
  1320.      If you downloaded a mail packet and do not yet have an Offline reader
  1321.      program, you may want to download one from the BBS now.  Otherwise,
  1322.      that's about it for setting up the BBS, so logoff by entering 'G' for
  1323.      G)oodbye.  If you are not using a mail reader program, please proceed to
  1324.      the next section.  Setting up a mail reader is a fairly involved topic,
  1325.      and largely depends on the reader you select so I'll just cover the
  1326.      basic steps to get you going.  (This does not apply to MegaMail-type
  1327.      readers.  Please refer to your reader documentation for information.)
  1328.  
  1329.      4.1  Choosing a Reader
  1330.  
  1331.       First you need a reader if you don't have one.  At the writing of this
  1332.       document, the two popular readers were Qmail Deluxe by Mark Herring
  1333.       (author of the Qmail door) and EZ-Reader by Eric Cockrell.  Both will
  1334.       allow you to read QWK packets downloaded from either a MarkMail or
  1335.       Qmail door (and other doors using the same packet format), so it's up
  1336.       to you as to which reader you choose.
  1337.  
  1338.       EZ-Reader is Shareware, and you should be able to find a copy on your
  1339.       BBS by typing "Z READER A" from an appropriate conference (Zippy scan
  1340.       for "READER" in All areas)  You should also run into Mark Herring's
  1341.       Shareware reader, but you won't find Deluxe on your BBS, since it's for
  1342.       registered users only.  Mark's Shareware reader may be updated in the
  1343.       future to give you a better idea of what Deluxe is like, but at the
  1344.       writing of this document the Shareware reader and Deluxe bore little
  1345.       resemblance (DeLuxe is MUCH better than the Shareware reader).  The
  1346.       Shareware Qmail reader will allow you to get started though, and is
  1347.       useful for the registration form to order Deluxe.  Use your discretion,
  1348.       and talk to other mail reader users via your BBS (in an appropriate
  1349.       conference) for information as to which reader is best suited to your
  1350.       needs.  Download both, then logoff by typing 'G'.
  1351.  
  1352.      4.2  Configuring the Reader
  1353.  
  1354.       When you get your reader(s) installed (do this later), the usual steps
  1355.       are to define a message packet directory (where the reader will look
  1356.       for the QWK packets you download from the door... normally your Telix
  1357.       download directory, but The Liberator allows you to define another
  1358.       directory) a Reply directory (where the reader will create an <ID>.REP
  1359.       file containing your replies to upload back to the door), and an editor
  1360.       to enter replies and new messages to upload back to the door.  You must
  1361.       also define 'packer' commands, that the reader will use to uncompress
  1362.       QWK packets, and to compress your REP (replies) packet.
  1363.  
  1364.       Getting the reader to communicate properly with your favorite word
  1365.       processor or editor is normally where people run into problems. 
  1366.       However, if you follow your reader's documentation carefully you
  1367.       shouldn't run into problems.  Mail readers are a subject all their own,
  1368.       so I won't get into it any further, but you can surely get a lot of
  1369.       help in your reader documentation and on your BBS.
  1370.  
  1371.  
  1372.  
  1373.  
  1374.      The  L i b e r a t o r  v2.32              Configuration Files - Page 19
  1375.      
  1376.      
  1377.  
  1378.                          5.  LIBERATOR CONFIGURATION FILES
  1379.  
  1380.  
  1381.      Now that we have that out of the way, we can set up a BBS Configuration
  1382.      File properly.  If you did not find a BBS Configuration when we were
  1383.      logged on to the PCBoard above, you may skip down to 'BBS Configuration
  1384.      File Setup'.
  1385.  
  1386.      5.1  Installing A Pre-defined Configuration
  1387.  
  1388.       If you found a Liberator Configuration File on your BBS, type <Alt-J>
  1389.       from Telix terminal mode (or any Liberator prompt) to shell to DOS,
  1390.       switch to your Telix Download Directory and uncompress the file if
  1391.       necessary.  PKUNZIP <filename> for a .ZIP file, PKUNPAK <filename> for
  1392.       an .ARC file.  If you don't have these programs (pkzip/pkunpak), you
  1393.       know how and where to get them... they are available on just about any
  1394.       IBM-oriented BBS.
  1395.  
  1396.       Next, simply copy the CFG file (or files) into your Telix script direc-
  1397.       tory, or Configuration File directory, if you specified one (e.g. COPY
  1398.       *.CFG C:\TELIX\SCRIPTS).  Once the Configuration is in your script
  1399.       directory, type EXIT to return to Telix, and start The Liberator by
  1400.       typing <Alt-G> then entering LIBERATE.  From the main menu, select
  1401.       'Tools', then 'Convert files to v2.3 format'.  The new Configuration
  1402.       (and all your other files, but it will only take a second) will then be
  1403.       checked and converted to v2.3 format if necessary.
  1404.  
  1405.      5.2  Configuration File Setup
  1406.  
  1407.       BBS Configurations, once set up, can normally be forgotten.  You do not
  1408.       have to go through all these steps each time you want to set up a job
  1409.       to execute on a PCBoard.  Only one Configuration File need be setup for
  1410.       each PCBoard and you can then set up as many jobs as you like for that
  1411.       BBS without creating a new Configuration.
  1412.  
  1413.       If you are not in The Liberator's Command File Manager, start the
  1414.       program now by typing LIBERATE from DOS, or entering <Alt-G> LIBERATE
  1415.       from Telix terminal mode.  Once again, select 'C'reate to get started,
  1416.       and either enter a 0 if creating a new Configuration, or enter the
  1417.       number beside the pre-defined BBS Configuration, if you found one on
  1418.       the BBS.  If you found multiple configurations on the BBS, select the
  1419.       'main' one, or the one that looks like it is used for general use.
  1420.  
  1421.      5.3  PCBoard Setup Screen 
  1422.  
  1423.       'Name used on PCBoard' should be set to the name you used to log on to
  1424.       the PCBoard above.  Select this entry now by entering a '1' (on the top
  1425.       row, and not the numeric keypad).  Then, type the name used on the
  1426.       PCBoard (use <Ctrl-End> or the <Del> key to clear any trailing charac-
  1427.       ters from the entry), and hit <Enter>.
  1428.  
  1429.       'Telix Directory Numbers to Dial' is where you store Telix Dialing
  1430.       Directory entry numbers for the PCBoard.  If no numbers are entered,
  1431.  
  1432.  
  1433.  
  1434.  
  1435.      The  L i b e r a t o r  v2.32              Configuration Files - Page 20
  1436.      
  1437.      
  1438.  
  1439.       The Liberator will display the Telix dialing directory at runtime to
  1440.       allow you to select entries manually. However, to avoid having to
  1441.       select the entries each time, you may specify up to 10 Telix directory
  1442.       entries in this option (10 is the Telix maximum). Select the option
  1443.       now, and you will see a large editing box appear.  This box is used for
  1444.       all entries that exceed the length of the display window to the right
  1445.       of the screen.  If there were actual entry numbers in the option, they
  1446.       will be moved to the box for editing.
  1447.  
  1448.       Some options display reminders, such as the one here.  If you press
  1449.       <Alt-D>, the Telix dialing directory will be displayed to allow you to
  1450.       edit or view any entry.  Hit <Alt-D> now and move the dialing directory
  1451.       highlight bar to any valid PCBoard entry.  Select 'Edit' and just
  1452.       confirm that all the information is entered correctly, and that your
  1453.       password for this BBS is entered in the 'Password' option near the
  1454.       bottom (this is also required for operation of PCBOARD.SLC, and most
  1455.       Telix scripts).  Next, take note of the directory entry number to the
  1456.       left of the PCBoard name.  If there is more than one entry for this
  1457.       PCBoard, please confirm that your password is entered in each one, take
  1458.       note of all entries, then hit <Esc> or type 'X' to exit the dialing
  1459.       directory.
  1460.  
  1461.       Now type the directory entry number(s) in the box.  If more than one is
  1462.       to be used, separate each number with a space (e.g. 30 31 32) up to 10
  1463.       entries, or 64 characters which is the Telix maximum, then hit <Enter>.
  1464.  
  1465.       'PCBoard version' is the PCBoard software version number being used at
  1466.       the BBS, which we took down above.  Specify the full version number,
  1467.       and one decimal -- even if a 0 (e.g. 14.0).  New features were intro-
  1468.       duced in PCBoard 14.5, and The Liberator must know whether they are
  1469.       available before attempting to make use of them.  Note that if you
  1470.       enter a version 14.5 or greater, you will be asked if you wish to make
  1471.       use of Batch transfers.  If you answer 'Y'es, the file transfer prompts
  1472.       will be automatically adjusted for batch operation.  To change out of
  1473.       batch mode, select the item again, and answer 'N' when asked whether to
  1474.       perform batch transfers.
  1475.  
  1476.       'Redial attempts' holds the number of dialing attempts you want The
  1477.       Liberator to make before giving up.  Actually, The Liberator just
  1478.       passes the number defined here, and the entry numbers, to the Telix
  1479.       dialing routines, and Telix handles all dialing.  If you defined 3
  1480.       dialing directory entries in option 2 above, and set this option to '3'
  1481.       redial attempts, then each entry will be tried once.  If you have only
  1482.       a single entry defined and you set '3' redial attempts, the single
  1483.       entry will be tried three times (a TOTAL of 3 attempts will be made. 
  1484.       This is just the way Telix works, and not a function of The Liberator). 
  1485.       If you want to dial repeatedly, until a connection is established,
  1486.       leave this item at '0'.  Note that this 'Redial attempts' value is only
  1487.       used when calling this BBS by itself.  When calling multiple BBSes with
  1488.       the Master, a dialing queue is used, and you may set a separate lower
  1489.       number of redials if desired.
  1490.  
  1491.  
  1492.  
  1493.  
  1494.      The  L i b e r a t o r  v2.32              Configuration Files - Page 21
  1495.      
  1496.      
  1497.  
  1498.       'Response delay time' is used to make The Liberator slow down its entry
  1499.       of responses to questions.  Sometimes a PCBoard may not be fast enough
  1500.       to handle the speed with which The Liberator answers questions.  This
  1501.       can be remedied by setting a response delay.  Tenths of a second are
  1502.       used, so a delay of 1 is one tenth of a second, 5 is half a second,
  1503.       etc. Usually this item can remain at 0, but if you notice responses
  1504.       coming out too fast, or not at all, try setting a delay.
  1505.  
  1506.       'Backspace protection' is a new feature in The Liberator v2.3, and is
  1507.       used as protection against line noise.  Even though The Liberator
  1508.       answers questions very rapidly, sometimes line noise sneaks in before
  1509.       it responds to a question, or may sneak in while pausing for the
  1510.       Response Delay set above.  The result is something like this:
  1511.  
  1512.       Please enter your first name? !@$%^Sig Tingloff
  1513.  
  1514.       The garbage characters before the name are caused by noise on the
  1515.       telephone lines, and prevent proper entry of the response.  The
  1516.       Liberator defaults to sending five backspaces before entering each
  1517.       response, which would eliminate the line noise above.  If no line noise
  1518.       is present, the backspaces are sent anyway, but PCBoard ignores them so
  1519.       they don't do any harm (the MarkMail door does not ignore them, and
  1520.       actually complains vigorously, so backspace protection is automatically
  1521.       disabled there).  You can have up to 30 backspaces sent before each
  1522.       response, which should be enough to eliminate even the worst line
  1523.       noise.  The backspaces are sent very rapidly, and the response is
  1524.       entered immediately afterwards, so there isn't much chance of any noise
  1525.       sneaking through once the entry starts.  If for some reason you want to
  1526.       turn the feature off, you can do so by entering a zero here.
  1527.  
  1528.       'Language to use' is not implemented on most PCBoards, and may remain
  1529.       set at 1 if only one language is supported.  If more than one language
  1530.       is supported, enter the number for 'English', if available, so you
  1531.       won't have to reset all The Liberator's prompts for another language. 
  1532.       Some PCBoards also have a special language for 'scripts' such as The
  1533.       Liberator, which normally uses all the standard English PCBoard prompts
  1534.       (which is what The Liberator defaults to).  You should use this
  1535.       language if available.
  1536.  
  1537.       'PCBoard Graphics' (color) should stay at 'n' for No, unless is it
  1538.       essential to have color turned on for some reason.  Having graphics on
  1539.       slows things down, and this option may be removed entirely in the
  1540.       future, since having graphics on also sends special codes which
  1541.       sometimes confuse Telix's tracking routines.
  1542.  
  1543.       'Conference to Join at Startup' is used mainly for PCBoards which
  1544.       always force you to start at the 'Main' conference.  On some PCBoards,
  1545.       CRS for example, most IBM-specific files are only available from the
  1546.       IBM conference.  In a case such as this case, you should set The
  1547.       Liberator to join this conference at startup.  As well, you may have
  1548.       had to join a specific conference to find a DOOR when we were logged on
  1549.       above, and in this case you should enter the conference number here. 
  1550.       The conference NAME can also be used, if supported in the BBS.
  1551.  
  1552.  
  1553.  
  1554.  
  1555.      The  L i b e r a t o r  v2.32              Configuration Files - Page 22
  1556.      
  1557.      
  1558.  
  1559.  
  1560.       'Mail Door'  This entry holds the name or number of the Mail Door on
  1561.       the BBS.  If you found a Mail Door on the door menu, while on the BBS,
  1562.       enter its number here. The header (the line at the top of the screen)
  1563.       will then change from 'Screen 1 of 3' to 'Screen 1 of 4'.  If the
  1564.       PCBoard supports door NAMES you may also enter the name of the door
  1565.       (e.g. QMAIL4).
  1566.  
  1567.       'ProBank Door'  This door is used to deposit online time, to be used in
  1568.       a later session.  The Liberator allows you to withdraw time from the
  1569.       ProBank before starting a session, and can also deposit as much time as
  1570.       you like when the session completes.  Enter the ProBank door number
  1571.       here if your BBS has one.  The door NAME can be used if door names are
  1572.       supported on the BBS (e.g. BANK).
  1573.  
  1574.       'ProDoor'  This door is like another BBS within PCBoard and it supports
  1575.       many features that are not available on PCBoard.  The Liberator allows
  1576.       you to enter ProDoor for 'batch' file transfers (explained above) and
  1577.       to make use of the extra protocols and conferences that are usually
  1578.       available only in ProDoor.  As well, customized commands can be defined
  1579.       and sent by The Liberator in ProDoor to take advantage of the door's
  1580.       many enhanced commands.  Enter the ProDoor number here, if your BBS has
  1581.       one.  The door NAME can also be entered, if door names are supported on
  1582.       your BBS (e.g. PRODOOR).
  1583.  
  1584.       'Online time to save/Max online time'  Online time to save is also a
  1585.       new feature in The Liberator v2.3.  This refers to the actual online
  1586.       time you have available each day on the BBS.  The Liberator can read
  1587.       the time from the PCBoard/Qmail/ProBank/ProLogon/ProDoor main menu
  1588.       lines (assuming your Sysop is using the standard format), to determine
  1589.       how much time you have left.  If the time set in this option is
  1590.       reached, The Liberator cancels further jobs and logs off.  The option
  1591.       comes preset to save 5 minutes of online time, which leaves enough time
  1592.       to get on and get into the ProBank to get more time out.  You may want
  1593.       to perform one automated session per day, but also want to logon later
  1594.       in the day to do some work manually.  In this case, just set 'Online
  1595.       time to save' to the number of minutes you wish to save for you manual
  1596.       session. (Note that the online time will almost surely not be exactly
  1597.       what you set here, since the online time can only checked between major
  1598.       jobs, when The Liberator is at a prompt displaying your available time. 
  1599.       Allow some leeway).
  1600.  
  1601.       'Max online time' is the total number of minutes to stay online before
  1602.       logging off, regardless of how much online time you have left.  This is
  1603.       mainly used to limit the total connect time for long-distance calls,
  1604.       etc.  Again, the connection may not be broken exactly at the number of
  1605.       minutes you specify here.  The Liberator can only check the elapsed
  1606.       time when it has control of your computer (Telix has control during
  1607.       file transfers).  If you specify 30 minutes maximum, and if 25 had
  1608.       elapsed, The Liberator would still start a 50,000 byte file transfer,
  1609.       which may take longer than the specified time.  Once the transfer was
  1610.       complete, The Liberator would see it was past the allotted time and
  1611.       logoff...  Again, allow some leeway.
  1612.  
  1613.  
  1614.  
  1615.  
  1616.      The  L i b e r a t o r  v2.32              Configuration Files - Page 23
  1617.      
  1618.      
  1619.  
  1620.       'Telix/PCBoard Upload Protocol'  When this option is selected, a menu
  1621.       of the most common Telix protocols will be displayed to allow a visual
  1622.       selection of the desired protocol.  If the protocol you want is not on
  1623.       the menu, select 'O'ther and enter the Telix protocol letter you wrote
  1624.       down earlier (if you forgot the letter, hit <PgUp> to view the Telix
  1625.       protocol menu).  When the Telix protocol letter is entered, you will be
  1626.       prompted to enter the corresponding PCBoard letter for the same
  1627.       protocol.  If you are using your default PCBoard protocol enter an 'N'. 
  1628.       Otherwise enter the letter you wrote down earlier at the PCBoard
  1629.       protocol menu.
  1630.  
  1631.       'Telix/PCBoard Download Protocol'  This is normally set the same as the
  1632.       entry above, but if you are using an error-correcting modem and wish to
  1633.       use a 'G' protocol for downloads, enter the proper letters here.
  1634.  
  1635.       'Custom Logon/Logoff Scripts' This entry is used to handle special
  1636.       logons and/or logoffs that are not supported internally by The Liberat-
  1637.       or (The Liberator has built-in support for PCBoard logons).  You can
  1638.       use this option to handle iNet/Datapac logons/logoffs, or any other
  1639.       logon/logoff for which you have a working Telix script.  The logon
  1640.       script, if defined, is executed as soon as The Liberator establishes a
  1641.       connection, and the defined script should carry out whatever is
  1642.       necessary to get to the PCBoard CONNECT.  The Liberator will pick
  1643.       things up from there (The Liberator can also carry on after a partial
  1644.       PCBoard logon).  The logoff script, if defined, is executed as soon as
  1645.       PCBoard sends the 'Run Logoff Script' prompt, defined on CFG screen 2
  1646.       (normally 'Thanks for calling').  Support for iNet logons/logoffs is
  1647.       included with The Liberator.
  1648.  
  1649.       'Usage Log'  The Liberator makes extensive use of this file for
  1650.       stamping various status/error messages.  This can be helpful when
  1651.       trying to figure out what went wrong with a session, and the Usage Log
  1652.       should be the first place you look for error messages.  You are allowed
  1653.       to clear the entry, thereby turning off the Usage Log, but this is not
  1654.       recommended unless absolutely necessary, since many status/error
  1655.       messages would be lost. 
  1656.  
  1657.       'Upload Directory' This is the same as the Upload Directory defined
  1658.       within Telix, but if you want to use a different drive/directory for
  1659.       this BBS, then define it here.  When you request an upload (to send a
  1660.       file to the BBS), The Liberator will look for file(s) to upload in the
  1661.       directory defined here, unless you specify another path in your Upload
  1662.       List.  The exception to this is REP files (replies to upload to a Mail
  1663.       Door) and PTR files (pointer reset, for Qmail v3/4) which have
  1664.       separately defined directories on screen 4.
  1665.  
  1666.       'Download Directory' This is the same as above, but for downloads.  All
  1667.       files downloaded (received) from the BBS are placed in this directory. 
  1668.       The exception to this is QWK packets (containing messages from a Mail
  1669.       Door) which can be placed in a separate directory, defined on screen 4.
  1670.  
  1671.       That's it for screen 1, so please press the <Down arrow> or <PgDn> key
  1672.       to move to the next screen.  Note that the bottom line displays the
  1673.  
  1674.  
  1675.  
  1676.  
  1677.      The  L i b e r a t o r  v2.32              Configuration Files - Page 24
  1678.      
  1679.      
  1680.  
  1681.       up/down arrows to remind you how to change screens, if you forget. 
  1682.       <PgUp> / <PgDn> may also be used.  Note that <up> from screen 1 takes
  1683.       you to screen 3 (or 4, if a Mail Door is defined), and <down> from the
  1684.       last screen takes you to back to screen 1.
  1685.  
  1686.      5.4  PCBoard Prompts Screen
  1687.  
  1688.       Unless your Sysop has redefined the format of some prompts (e.g.
  1689.       changed 'What is your first name?' to 'Yo dude, what's your name?'), or
  1690.       is using a different language, you may never need to change anything on
  1691.       screen 2.  Prompts may also need changing if setting up for an older
  1692.       version of PCBoard (older than 14.0).  The Liberator operates by
  1693.       watching for these prompts/messages to come in, then enters the cor-
  1694.       responding response for what it thinks it found (most of the prompts
  1695.       the program watches for can be redefined by you).  For some prompts,
  1696.       The Liberator doesn't enter a response, but carries out some operation,
  1697.       such as starting a file transfer, etc.
  1698.  
  1699.       Note that some prompt descriptions are followed by an asterisk (*). 
  1700.       These are 'key' prompts, from which The Liberator can start any job. 
  1701.       There are eight key prompts altogether (4 on the next screen, 2 on Mail
  1702.       Configuration screen 4), and The Liberator can start any job from any
  1703.       of these prompts.  For example, if you are in the Qmail Door, you can
  1704.       start The Liberator online and select a Command File set up for a
  1705.       ProDoor batch transfer.  The Liberator will then check the prompt,
  1706.       realize it's in the Qmail door, Q)uit from the Qmail Door, OPEN the
  1707.       ProDoor, and start the transfer.  Same goes for any other job that you
  1708.       set up in The Liberator.  If you get a message '<< Unable to locate a
  1709.       recognizable prompt >>', then none of the eight key prompts could be
  1710.       located. Information on setting the prompts on screen 2, 3, and 4 is
  1711.       discussed in the section 'Configuring Prompts' below.
  1712.  
  1713.      5.5  Pro Utilities Screen
  1714.  
  1715.       ProLogon is a 'front door' program for PCBoard.  If your BBS is using
  1716.       it, you'll know -- it can totally change the face of PCBoard, and
  1717.       created a fairly major hurdle for this release of The Liberator
  1718.       (ProLogon is now automatically supported, if found on your BBS). 
  1719.       ProBank is a door used to deposit and withdraw online time.  ProDoor is
  1720.       a complete BBS inside a BBS.  If no Pro Utilities are available on your
  1721.       BBS (ProLogon, ProBank, ProDoor), then you will not need to configure
  1722.       anything on screen 3 either.  If you found a ProDoor when we were
  1723.       logged on, one thing to note on this screen if using ProDoor for file
  1724.       transfers, is item 3:
  1725.  
  1726.       'Transfer in ProDoor if how many files?'.  On some PCBoards, doors take
  1727.       quite a while to OPEN, and it may not be worth it to enter ProDoor just
  1728.       to transfer one or two files.  This is what item 3 is for: to limit the
  1729.       use of ProDoor to a certain number of files.  If a ProDoor is defined,
  1730.       before starting any file transfers, valid filenames are counted on both
  1731.       your Upload and Download Lists.  If the total number of files on both
  1732.       lists is equal to or greater than the number defined in item 3, the
  1733.       ProDoor will be OPENed and the transfer (which is a much faster 'batch'
  1734.  
  1735.  
  1736.  
  1737.  
  1738.      The  L i b e r a t o r  v2.32              Configuration Files - Page 25
  1739.      
  1740.      
  1741.  
  1742.       transfer) will take place there.  If there are less files than that
  1743.       defined in item 3, ProDoor will not be opened and the transfer will
  1744.       take place on PCBoard.
  1745.  
  1746.       If you want ALL your transfers to take place in ProDoor, regardless of
  1747.       how many files are on your list (assuming you have already defined a
  1748.       ProDoor on screen 1), enter a '1' in this option.  If you want all your
  1749.       transfers to take place on PCBoard (for example, using the 'DB'
  1750.       command), enter a '0' in item 3.  Otherwise, enter whatever number of
  1751.       files you feel it would be worthwhile to OPEN the ProDoor for.
  1752.  
  1753.       'Number of files per ProDoor batch' can be used to limit the number of
  1754.       filenames that are entered before transferring each batch.  If you set
  1755.       it to '5', then five filenames will be entered, these files will be
  1756.       transferred, then five more filenames entered, etc.  Normally you can
  1757.       leave this set to a high number, since The Liberator will usually
  1758.       automatically recognize when a batch is full.  However, if a batch is
  1759.       not started when prompted, set this number to 1 less file than the
  1760.       number of filenames entered.  As many batches as you have time for are
  1761.       carried out.
  1762.  
  1763.       Enter your ProDoor Upload/Download protocols in the same manner as your
  1764.       PCBoard protocols on screen 1, but using the ProDoor protocol letters
  1765.       you took down above in the door.  The rest of the items on this screen
  1766.       will need changing only if your Sysop has changed the standard prompts,
  1767.       or an old/very new version of ProDoor is being used.  If you have
  1768.       problems with any Pro Utilities, you will know which screen to come to
  1769.       for redefinition of prompts.  Also note the four 'key' prompts on this
  1770.       screen (the descriptions followed by an asterisk), from which any
  1771.       Liberator job can be started.
  1772.  
  1773.       Hit <Down arrow> to move to screen 4.  If no Mail Door was defined on
  1774.       screen 1, you will instead move back to screen 1, and may proceed to
  1775.       'Saving a BBS Configuration' below.
  1776.  
  1777.      5.6  Mail Door Setup Screen
  1778.  
  1779.       'Packet ID' is the ID of the mail packet that we obtained when we were
  1780.       in the Mail Door.  Enter the proper ID here.  If using a MegaMail-type
  1781.       door, the Node ID can be obtained through your Sysop, or try reading
  1782.       the B)ulletins on the BBS or asking a friend.
  1783.  
  1784.       'Door type' is the type of mail door being used on the BBS, which we
  1785.       noted earlier.  To change the type, select item 2 and enter the number
  1786.       which corresponds to the door being used on the PCBoard.  If you are
  1787.       setting up a pre-defined Configuration, this item should already be set
  1788.       to the proper type of door.  Selecting a different door type will
  1789.       automatically update the prompts, and you will lose any changes you had
  1790.       made to the prompts on the screen.
  1791.  
  1792.       'Perform Mail transfers last' is for use on PCBoards that don't allow
  1793.       you to Q)uit from the Mail door after use.  If you set this to 'y'
  1794.       (yes), the Qmail transfers will take place last, after all other jobs.
  1795.  
  1796.  
  1797.  
  1798.  
  1799.      The  L i b e r a t o r  v2.32              Configuration Files - Page 26
  1800.      
  1801.      
  1802.  
  1803.       'Number of message packets to keep' is the maximum number of packets to
  1804.       rename or 'renumber'.  If you set this to '5', The Liberator will keep
  1805.       your last five message packets for that board on hand by
  1806.       renaming/deleting older packets as new ones come in.  Up to 99 packets
  1807.       can be handled in this manner, and all renumbering will take place
  1808.       OFFLINE before dialing (assuming you aren't already online when you
  1809.       start The Liberator) to avoid wasting online time.  The Liberator
  1810.       allows two renumbering formats; the default being <packet-id>nn.QWK,
  1811.       where nn is a number from 1 to 99, and an alternate method of <packet-
  1812.       id>.Qnn, where the <packet-id> is left undisturbed.  The alternate
  1813.       method can be selected using the main menu 'Tools' option, and
  1814.       selecting 'Configure'.  If you don't want your packets renumbered, set
  1815.       this option to '0' and old packets will simply be deleted just before a
  1816.       new packet is downloaded.
  1817.  
  1818.       'Number of reply packets to keep' is the same as above, but for your
  1819.       reply packets.  Reply packets will also be maintained offline, after
  1820.       the connection is broken, if possible.
  1821.  
  1822.       'Mail Door Protocols'  The protocols in the next two options should be
  1823.       entered as defined when setting up the Mail Door.  Note that the 'Door
  1824.       Upload/Download Protocol' options (following the Telix protocols after
  1825.       the /) should both be set to 'None (default)' unless using a Qmail v3/4
  1826.       door and using separate upload and download protocols.  Other doors do
  1827.       not permit the use of separate upload/download protocols, and you must
  1828.       use the default protocol as you defined in the door.
  1829.  
  1830.       'SESSION.TXT pack command' is the command needed to add a file to your
  1831.       newly downloaded QWK packets.  The SESSION.TXT file was temporarily
  1832.       discontinued in the Qmail v3 door, and it simply contained the same
  1833.       screen that is displayed after your message packet is collected (where
  1834.       you are asked if you want the packet or not).  It shows the number of
  1835.       messages found in each conference, etc., and if this file exists in
  1836.       your QWK packet, your reader will display it when you open the packet
  1837.       for reading.  This can be useful to give you some idea what's coming in
  1838.       the packet.  The command to enter here is simply the name of the proper
  1839.       archiver, depending on the format of the packet.  For example, if your
  1840.       QWK packet comes in ZIP format, you would enter PKZIP (or whatever you
  1841.       renamed PKZIP.EXE to).  If your packet comes in ARC format, enter
  1842.       PKPAK, etc.  If a command is entered, The Liberator will capture the
  1843.       packet information screen to a file called SESSION.TXT, and will insert
  1844.       the file in the appropriate QWK packet when you disconnect from the
  1845.       BBS.
  1846.  
  1847.       'Message/Reply/PTR directories' must be set to the same directories
  1848.       defined in your reader.  If you set C:\QWK as your Message Packet
  1849.       Directory in your reader, then you must set the same directory here in
  1850.       the Configuration.  Same with the Reply packet directory, according to
  1851.       how your reader is set up.  Note that the PTR directory is only useful
  1852.       for those using Qmail v3/4 doors, which place a <packet-id>.PTR file in
  1853.       your packet containing information about your message pointers (Deluxe
  1854.       automatically extracts this file and places it in your 'Archive
  1855.       Directory' when you open the packet).  The file can later be uploaded
  1856.  
  1857.  
  1858.  
  1859.  
  1860.      The  L i b e r a t o r  v2.32              Configuration Files - Page 27
  1861.      
  1862.      
  1863.  
  1864.       to the door by The Liberator to reset your messages pointers quickly in
  1865.       a number of conferences.
  1866.  
  1867.       The rest of the items will only need changing if your Sysop has changed
  1868.       the standard prompts, so that's about it for BBS Configurations!  Refer
  1869.       to the section 'Configuring Prompts' for prompt configuration informa-
  1870.       tion, if necessary.
  1871.  
  1872.      5.7  Saving a Configuration File
  1873.  
  1874.       You can save the Configuration by hitting <Enter> when the cursor is
  1875.       next to the 'Enter = Save' prompt.  Hitting <Enter> (or <Esc>) here
  1876.       will call up the save window, where you can do one of three things:
  1877.  
  1878.       a) Hit <Esc> to abort saving the file.  Any changes you made are
  1879.          discarded and not written to disk.
  1880.  
  1881.       b) Enter a new name to save the file under.  If there is a <packet-id>
  1882.          for the BBS, this is a good choice for the Configuration name.  If
  1883.          not, just enter an abbreviated name that will remind you of the BBS. 
  1884.          The file will then be saved as <name>.CFG, where <name> is the name
  1885.          you enter.  Configuration Files are normally saved in your Script
  1886.          directory, but you may change this with the main menu 'Tools' option
  1887.          under 'Configure'.
  1888.  
  1889.       c) If you were editing a Configuration created previously (such as if
  1890.          are editing one we found one on the PCBoard), you can give the file
  1891.          a different name.  This will cause the file we started with to be
  1892.          left alone, and will create a new file using a different name. (e.g.
  1893.          you start by editing BBS.CFG, but save it as BBS1).  This can be
  1894.          useful to 'clone' previously created BBS Configurations and cut down
  1895.          on setup time.
  1896.  
  1897.       For our purposes, please save the file by typing in a name and hitting
  1898.       the <Enter> key, or by simply hitting <Enter> if you are editing a
  1899.       Configuration from the BBS.  You will then automatically move the
  1900.       'Create Command File' screen.
  1901.  
  1902.      5.8  Cloning or Editing Configuration Files
  1903.  
  1904.       To edit or just view a previously created Configuration, select 'Edit'
  1905.       from the main menu, type <Alt-E> to edit a Configuration, then select
  1906.       the file you want to view/edit from the menu.  If you found multiple
  1907.       pre-defined BBS Configurations on your BBS, use this method once we get
  1908.       back to the main menu, to set the rest of the Configurations up
  1909.       properly (you have to enter your name and the proper dialing directory
  1910.       entry #'s in each CFG). To edit a Configuration from the Command File
  1911.       Editor screen (the screen you are looking at now), select option 1
  1912.       'Configuration File' then hit <Alt-E>.  To clone a Configuration, use
  1913.       either of the above methods, make any changes you like, then simply
  1914.       save the file using a different name.
  1915.  
  1916.  
  1917.  
  1918.  
  1919.      The  L i b e r a t o r  v2.32                    Command Files - Page 28
  1920.      
  1921.      
  1922.  
  1923.                             6.  LIBERATOR COMMAND FILES
  1924.  
  1925.  
  1926.      Command Files define what jobs you want done on a BBS in a given
  1927.      session.  You may create up to 99 Command Files, to carry out an almost
  1928.      limitless variety of sessions on many different PCBoards.
  1929.  
  1930.      NOTE:  All options listed below can be set to interactive mode by
  1931.      entering a question mark in the option.  When the Command File is
  1932.      executed, you will be prompted for a response to any interactive
  1933.      options.  This allows the level of interaction, for any given Command
  1934.      File to be tailored to suit your needs.
  1935.  
  1936.      'Configuration File' can be thought of as the BBS itself; as this is how
  1937.      you tell The Liberator which BBS to execute the defined jobs on.  The
  1938.      actual jobs to carry out are defined below.  Note that the BBS Con-
  1939.      figuration we just saved has already been placed in option 1 for you,
  1940.      but you could select option 1 to use another Configuration (for another
  1941.      BBS... or even just a different setup for the same BBS) if you had
  1942.      Created others.  You can also edit the currently named Configuration at
  1943.      any time by selecting item 1 and hitting <Alt-E>.  You can even enter a
  1944.      question mark (?) in the option, as you can with any of the options
  1945.      below, to select the Configuration (BBS) at runtime.
  1946.  
  1947.      'Dial Starting Time' is the time you want this Command File to start
  1948.      running.  If you define a specific time, say 4am (04:00), then each time
  1949.      you select the Command File from the main menu, The Liberator will pause
  1950.      until 4am before dialing and carrying out the defined jobs.  Time is
  1951.      specified in 24 hour (military) format, so 12:00 is noon, 00:00 is
  1952.      midnight, 17:00 is 5pm, etc.  Just add 12 if entering a PM time (1pm +
  1953.      12 = 13:00... 1am = 01:00 -- do not add 12 for AM times).  When you
  1954.      select this option, the current time or the previously saved dial
  1955.      starting time will be displayed for editing.  Enter an 'N' (Now) as the
  1956.      *first* character (you needn't clear all the other characters) to cancel
  1957.      a dial starting time and have the Command File execute as soon as you
  1958.      select it.
  1959.  
  1960.      'Capture File' is the drive, path, and filename used to capture the
  1961.      session.  The default name given is made up by extracting the drive/-
  1962.      directory from your current Telix capture file, then adding the name of
  1963.      the BBS Configuration and the extension .CAP.  Feel free to change it to
  1964.      any name you like (you might want to get used to the default format,
  1965.      since it will most likely be forced in v3 of The Liberator, to allow
  1966.      capture file maintenance).  Capture Files are quite useful for determin-
  1967.      ing problems with sessions, such as capturing a prompt that your Sysop
  1968.      redefined and caused the program to hang.
  1969.  
  1970.      'Sound'  If set to 'n' (None), then no sound at all will be heard,
  1971.      including Telix alarms and PCBoard beeps.  Really there is no need to
  1972.      have sound turned on when The Liberator is operating, since it handles
  1973.      everything automatically, and has no need for intervention.  Should you
  1974.      choose not to disconnect from the PCBoard (via item 14), sound will be
  1975.      turned on and you will be paged when the Command File completes. 
  1976.  
  1977.  
  1978.  
  1979.  
  1980.      The  L i b e r a t o r  v2.32                    Command Files - Page 29
  1981.      
  1982.      
  1983.  
  1984.      However, if you prefer you can turn sound on for the entire automated
  1985.      session by selecting this item and entering 'y' (yes).
  1986.  
  1987.      'ProBank Withdrawal' is used to set the number of minutes to withdraw
  1988.      from the ProBank.  The number of minutes set here will be taken out of
  1989.      the bank before any jobs start, immediately after the logon completes
  1990.      (if you are already online when you start The Liberator, the logon is
  1991.      bypassed).  If no ProBank door is defined in the CFG named in item 1,
  1992.      ProBank withdrawals will not be available and the item will display
  1993.      <N/A>.  If you have not used the ProBank before, you will have to
  1994.      accumulate some time using 'ProBank Deposit' below before attempting a
  1995.      withdrawal.  You may use The Liberator immediately to deposit time;
  1996.      ProBank requires no manual setup.
  1997.  
  1998.      'Custom Command[s] 1' is used to send your own commands to PCBoard, or
  1999.      run another Telix SALT script in the middle of, or even as a Liberator
  2000.      session.  Custom Commands can be used to read mail from systems without
  2001.      a Mail Door, or to carry out some of the smaller jobs that The Liberator
  2002.      doesn't directly support (reading bulletins, etc).  The commands can be
  2003.      as simple or as complex as you desire.  There is a section devoted to
  2004.      Custom Commands later in the manual, with some example commands, that
  2005.      you should refer to when you're ready to set up one up.  Custom Commands
  2006.      are a powerful and very easy-to-use option, and are well worth looking
  2007.      into when you have time.
  2008.  
  2009.      If you don't have a Mail Door defined in the Configuration, you may skip
  2010.      the next three items.
  2011.  
  2012.      'Qmail Pointer Reset Upload' should be set to 'y' (yes) if you wish to
  2013.      send a PTR reset file to the Qmail door (Qmail v3/4 only).  If using
  2014.      Deluxe, the proper file can be found in your 'Archive Directory', and
  2015.      you may edit the file to reset multiple conferences, or simply upload it
  2016.      as is to reset your pointers to where they were before you downloaded
  2017.      your last packet.  If you can't find the <packet-id>.PTR file, simply
  2018.      unpack it from your last QWK packet (e.g. PKUNZIP <id>.QWK <id>.PTR ...
  2019.      if PKUNZIP doesn't work or gives an error, try PKUNPAK, or LHARC, etc). 
  2020.      PTR files are useful if you get a bad packet, but the door updated your
  2021.      pointers.  You simply have The Liberator upload the PTR file, and all
  2022.      your pointers will be back where they were before your last download.
  2023.  
  2024.      'Mail Replies Upload' should be set to Yes if you want to send your
  2025.      replies back to the Mail Door.  The reply file is created by your
  2026.      reader, and holds any replies or new messages you entered while reading
  2027.      the message packet.  When the reply packet is uploaded, the Mail Door
  2028.      extracts the replies inside and inserts them in the BBS message base, in
  2029.      the correct conference, addressed to the correct person.  If the upload
  2030.      is successful, the packet is automatically deleted or renamed by The
  2031.      Liberator depending on the number you set in 'Number of reply files to
  2032.      keep' in the Configuration.  If the proper reply file cannot be found
  2033.      (if you haven't created any replies ... or gave the wrong <packet-id> or
  2034.      'Reply directory' in the CFG), The Liberator will cancel the upload
  2035.      request when you start the Command File, thus you may leave this set to
  2036.      Yes if desired.
  2037.  
  2038.  
  2039.  
  2040.  
  2041.      The  L i b e r a t o r  v2.32                    Command Files - Page 30
  2042.      
  2043.      
  2044.  
  2045.      'Mail Download' has a few different settings.  If set to Yes, a regular
  2046.      download will take place according to how you configured the door.  This
  2047.      is the only item available in MegaMail-type doors.  If set to Personal,
  2048.      only messages addressed to you will be downloaded.  If set to Repeat,
  2049.      downloading will continue until the 'No Mail Found' prompt is received. 
  2050.      This can be useful when you have a lot of catching up to do, and must
  2051.      download several packets (each packet has a limit as to its size). 
  2052.      Sysops may also find Repeat downloading useful when picking up echomail
  2053.      from a large hub.  If more than one packet is downloaded, you will find
  2054.      them in the form <packet-id>.QW0, <packet-id>.QW1, etc.
  2055.  
  2056.      If you select 'y', 'p' or 'r', and are set up for a Qmail v3/4 door, you
  2057.      will be asked if you wish to scan ALL conferences.  At release of The
  2058.      Liberator v2.3 this was only available in the Qmail v3/4 doors, and it
  2059.      causes every conference on the BBS to be scanned for messages, and not
  2060.      just the ones you configured in the door.  Answer 'y'es if you want ALL
  2061.      conferences scanned.
  2062.  
  2063.      'Custom Command[s] 2' is similar to Custom Command[s] 1, except that if
  2064.      a ProDoor is defined in the CFG, the Custom Command[s] will be executed
  2065.      in ProDoor instead of on PCBoard.  This allows you to take advantage of
  2066.      ProDoor's enhanced commands.  If no ProDoor is defined, the command is
  2067.      sent on PCBoard.  As with Custom Command[s] 1, you can also specify a
  2068.      SALT script to execute in this option.  The MakeList script, included
  2069.      with The Liberator, is an example of what can be done with these Custom
  2070.      Commands and secondary SALT scripts.
  2071.  
  2072.      'Upload List' is the drive, path, and filename of a Liberator Upload
  2073.      List.  If a list is specified here, all valid files on the list will be
  2074.      uploaded to the BBS, including entering the description for the file.
  2075.      These lists are quite simple to create, and when you are ready to do so,
  2076.      please refer to the 'File Transfers' section later in this manual.
  2077.  
  2078.      'Download List' is similar to the Upload List option above, but the list
  2079.      consists of names of files to download.  When you are ready to create a
  2080.      Download List, please refer to the 'File Transfers' section, and the
  2081.      section 'Creating a Download List using LIST.COM'.
  2082.  
  2083.      'ProBank Deposit' is where you set the number of minutes to deposit in
  2084.      ProBank, if available.  The deposit takes place after all other jobs are
  2085.      complete.  When you set a deposit, you can enter more than your
  2086.      available time to deposit all your time if you wish.  The Liberator will
  2087.      take your remaining online time and adjust the deposit to leave the
  2088.      number of minutes you set in the 'Online time to leave' item in the
  2089.      Configuration.  Normally this is 5 minutes, which leaves enough time to
  2090.      get into the door and take some more time out.
  2091.  
  2092.      'Disconnect' controls whether you want to log off, or stay connected
  2093.      when the Command File completes.  You can also set this option to
  2094.      disconnect, then exit to DOS if desired by entering 'e' (Exit to DOS). 
  2095.      If set to No, to remain online, when the Command File completes The
  2096.      Liberator will page you with an alarm every 10 seconds until you return
  2097.      and hit a key.  If you don't return within about 3-5 minutes, the BBS
  2098.  
  2099.  
  2100.  
  2101.  
  2102.      The  L i b e r a t o r  v2.32                    Command Files - Page 31
  2103.      
  2104.      
  2105.  
  2106.      will timeout and break the connection.  Again, set this item to 'No'
  2107.      now, so that just a logon will performed, and will leave you at the
  2108.      PCBoard prompt.   
  2109.      What you should have now is a Command File that does nothing but log
  2110.      onto the BBS (specified by 'Configuration File'), open a Capture File,
  2111.      then stay connected to allow you to carry out whatever you want to do:
  2112.      basically a logon script that opens a capture file.
  2113.  
  2114.      Hit <Enter> to save it, and create a name that will remind you of what
  2115.      the Command File does.  For example, if the Configuration File was
  2116.      called 'BBS', you might type in 'BBSLOGON', or BBS-ON as the name.  The
  2117.      file will then be saved in your Script directory as <name>.CMD, where
  2118.      <name> is the name you entered in the window.
  2119.  
  2120.      That's it!  You have now created a Command File, which specifies the
  2121.      jobs you want done, and a working BBS Configuration (actually this
  2122.      largely depends on your Sysop and the prompts on your BBS) which
  2123.      specifies which PCBoard you want the Command File to execute on.  You
  2124.      can now create as many of these Command Files as you want for this BBS,
  2125.      by selecting Create from the main menu, and entering the number of the
  2126.      BBS Configuration we created above.
  2127.  
  2128.      6.1  Running Command Files
  2129.  
  2130.       To run Command Files, the one we just Created for example, simply type
  2131.       the number beside the name you want to run.  Run your logon Command
  2132.       File now by typing its number.  If you receive a message that the
  2133.       program was not able to recognize any prompts, please see the section
  2134.       on Configuring Prompts below.  You can also start The Liberator and run
  2135.       Command Files when already connected, but you must get to one of the
  2136.       eight 'key' prompts first (the key prompts are signified by an asterisk
  2137.       following the prompt description, in the Configuration).  
  2138.  
  2139.      6.2  Command File Abort Codes
  2140.  
  2141.       The Liberator was designed to handle many errors that occur during the
  2142.       operation of a Command File, and can normally salvage a session even if
  2143.       errors occur, but sometimes it is necessary to abort the Command File
  2144.       and log off the BBS.  If this happens, a message will be printed on the
  2145.       screen (which can be read from the capture file or by using the Telix
  2146.       <Alt-B> 'Scrollback' command before leaving Telix) along with a number
  2147.       in brackets, called an 'Abort Code'.  All abort code values and their
  2148.       meanings and possible remedies are listed in the section 'Abort Codes/-
  2149.       Remedies' at the end of the manual.
  2150.  
  2151.      6.3  Pausing Or Manually Aborting Command Files
  2152.  
  2153.       To pause a Command File, hit the <Esc> key.  A menu box will then
  2154.       appear called the Control Menu.  From here you can carry out a number
  2155.       of tasks, or select option 1 to abort the Command File.  The Liberator
  2156.       does not just dump you back to terminal mode immediately when you
  2157.       abort, but will first take care of any details that need cleaning up;
  2158.       such as message reply packet maintenance, or adding the SESSION.TXT
  2159.  
  2160.  
  2161.  
  2162.  
  2163.      The  L i b e r a t o r  v2.32                    Command Files - Page 32
  2164.      
  2165.      
  2166.  
  2167.       file to your QWK packet (both of these tasks normally takes place
  2168.       offline, after the Command File completes).  As well, any system
  2169.       variables such as the default colors, Upload/Download directories are
  2170.       put back at their proper values.  The Usage and Capture files are
  2171.       purposely not reset however, to allow the remainder of your session to
  2172.       be recorded in the same files.  These files should be closed manually
  2173.       when you disconnect.
  2174.  
  2175.      6.4  Creating New Command Files
  2176.  
  2177.       The main menu Create option is used to create new Command Files (and
  2178.       Configurations if necessary).  When you are ready to create a new
  2179.       Command File, select Create then simply select the BBS Configuration
  2180.       you wish to use from the menu.  There is no need to create a new BBS
  2181.       Configuration each time you want to set up a new job.  As many Command
  2182.       Files as desired can be created for an existing Configuration.  To
  2183.       create a new Configuration, select Create, then enter '0' (or hit
  2184.       <Enter>) from the Configuration menu.
  2185.  
  2186.      6.5  Editing Existing Command Files
  2187.  
  2188.       The main menu Edit option is used to modify or view an existing Command
  2189.       File (or Configuration File as explained in the Configuration section). 
  2190.       To edit a Command File, select Edit and simply enter the number beside
  2191.       the file of your choice.  You can clone Command Files in the same
  2192.       manner as Configurations, by Editing an existing file and just saving
  2193.       it under a different name.
  2194.  
  2195.      6.6  Deleting Command/Configuration Files
  2196.  
  2197.       The main menu Delete option is used to delete any Command File, and its
  2198.       accompanying Configuration as well if necessary.  You can also delete
  2199.       these files right from DOS if you like, by switching to your Script
  2200.       directory (or Command/Configuration directory if defined) and using the
  2201.       DEL command.  Make sure you don't delete a Configuration if other
  2202.       Command Files are set up to use it, or these Command Files will be
  2203.       unusable.
  2204.  
  2205.      6.7  Renaming Command/Configuration Files
  2206.  
  2207.       The main menu reName option (selected with 'N') is used to give a
  2208.       Command and/or Configuration File a new name.  Simply enter the new
  2209.       names when prompted.  To rename the Configuration only, hit <Enter>
  2210.       when prompted for a new Command File name, then enter the new name for
  2211.       the Configuration.  The name will also be updated inside the accompany-
  2212.       ing Command File, but other Command Files that used the old name will
  2213.       not be updated and should be changed manually if necessary.
  2214.  
  2215.  
  2216.  
  2217.  
  2218.      The  L i b e r a t o r  v2.32          Liberator Configuration - Page 33
  2219.      
  2220.      
  2221.  
  2222.               7.  LIBERATOR CONFIGURATION (Tools 'Configure' option)
  2223.  
  2224.  
  2225.      'Master redial attempts' is the same as the redial attempts you entered
  2226.      in the BBS Configuration, but this number is used for the queue when the
  2227.      'Master' is running (discussed below).
  2228.  
  2229.      'Display Command File Delay' is used to display what the Command File is
  2230.      about to carry out, to give you a chance to abort.  You may increase or
  2231.      reduce the 10 second default here.
  2232.  
  2233.      'Qmail Packet Renumbering Type' is only of interest if you are using a
  2234.      Mail Door.  The Liberator can maintain (renumber) your packets in two
  2235.      ways: by placing the numbers in the <packet-id> portion of the filename,
  2236.      or in the file extension (QWK/REP).  This is where you can change the
  2237.      method used, if desired.
  2238.  
  2239.      'Text Editor' is the drive, path, and filename of your text editor. 
  2240.      What is a Text Editor?  A Text Editor is a very common tool, much like a
  2241.      word processor, but used to create 'DOS text files' (sometimes called
  2242.      ASCII files), such as BAT files, and even files like this document. 
  2243.      Text files can be read from DOS with the TYPE command, and do not need
  2244.      to be loaded into a special program like a word processor to be printed
  2245.      or viewed.  The Liberator expects your File Lists (used for upload-
  2246.      ing/downloading) to be in 'text file' format: without word processor
  2247.      formatting codes.  If you don't have a Text Editor, perform a Z)ippy
  2248.      scan on your BBS in the appropriate conferences (e.g. "Z EDITOR A" or
  2249.      Z)ippy scan, for EDITOR, in All areas).  There are many good Shareware
  2250.      editors available.  The Liberator uses the editor defined here to allow
  2251.      you to edit File Lists from within the program.
  2252.  
  2253.      'Command File Directory' is initially set to your Script directory, but
  2254.      if you prefer to keep this directory uncluttered, you can tell The
  2255.      Liberator to put your Command Files elsewhere.   Define the drive/path
  2256.      of any valid directory here.
  2257.  
  2258.      'Configuration File Directory' is the same as above, but for your BBS
  2259.      Configurations.
  2260.  
  2261.      Type <Alt-S> to save any changes you made, or <Esc> to exit, when
  2262.      finished with this screen.
  2263.  
  2264.  
  2265.  
  2266.  
  2267.      The  L i b e r a t o r  v2.32                  Custom Commands - Page 34
  2268.      
  2269.      
  2270.  
  2271.                           8.  SETTING UP CUSTOM COMMANDS
  2272.  
  2273.  
  2274.      Custom Commands allow you carry out jobs on PCBoard or in ProDoor that
  2275.      are not supported internally by The Liberator.  They are something like
  2276.      the macros you assign to keys in Telix, but are more powerful, and more
  2277.      oriented to PCBoard.  You can use Custom Commands to capture and
  2278.      download messages from systems without a Mail Door, or to carry out some
  2279.      PCBoard/ProDoor jobs that are not supported internally by The Liberator. 
  2280.      You can also capture the results of PCBoard/ProDoor commands to a user-
  2281.      defined capture file by executing the example CAPCMD.SLT script from a
  2282.      Custom Command, or for more advanced capture, the MakeList script
  2283.      included with The Liberator.
  2284.  
  2285.      There are two types of entries you can make in the 'Custom Command[s] 1'
  2286.      (to save some typing, I'll call this 'CC1') and 'Custom Command[s] 2'
  2287.      ('CC2') items of a Command File.  The first requires that you know a
  2288.      PCBoard or ProDoor command, or multiple commands (some examples are
  2289.      given below, if you don't).  In this case, you enter the PCBoard/ProDoor
  2290.      command in CC1 or CC2  pretty much the same as you would enter them on
  2291.      PCBoard.  The Liberator sends the defined command[s] when you run the
  2292.      Command File.
  2293.  
  2294.      The second type of Custom Command entry requires you to have a Telix
  2295.      script that does the job you want done (such as the MakeList script, or
  2296.      one of your own), and in this case you enter the script's name in CC1 or
  2297.      2 preceded by the '@' character, as in a Telix macro.  The @SCRIPTNAME
  2298.      may be followed by 'parameters', as outlined below.
  2299.  
  2300.      8.1  Defining a PCBoard or ProDoor Command
  2301.  
  2302.       To have a PCBoard command carried out, simply enter the desired command
  2303.       in CC1 or 2.  To have a ProDoor command carried out, you must define
  2304.       the command in CC2 and make sure a ProDoor is defined in the BBS
  2305.       Configuration being used (the Custom Command help screen will tell you
  2306.       to enter a 'ProDoor' command if a ProDoor is defined in the Configura-
  2307.       tion).  CC1 is always carried out on PCBoard, but The Liberator will
  2308.       OPEN the ProDoor first for CC2, if a ProDoor is defined in the BBS
  2309.       Configuration being used.  If no ProDoor is defined, CC2 is carried out
  2310.       on PCBoard.
  2311.  
  2312.       You should 'stack' your commands where possible, but you can also embed
  2313.       the command with <Enter>s (Carriage Return, or CR for short) if
  2314.       necessary.  Command stacking means that you enter all command options
  2315.       on one line.  For example, on PCBoard you can carry out a Zippy scan by
  2316.       typing a 'Z' then hit <Enter> and enter the text you want to scan for,
  2317.       hit <Enter> again then enter the file areas to scan, and hit <Enter>
  2318.       once more... then type NS (non-stop) and hit <Enter> again if the
  2319.       'More' prompt comes up.  Or you can enter the whole shot on one line:
  2320.  
  2321.       Z <text to scan for> <file areas> NS
  2322.  
  2323.  
  2324.  
  2325.  
  2326.      The  L i b e r a t o r  v2.32                  Custom Commands - Page 35
  2327.      
  2328.      
  2329.  
  2330.       This is how you should do it whenever possible in a Custom Command.  If
  2331.       you must use <Enter>(s) in your command, you may specify them right in
  2332.       the command as a control character (<Enter> is Ctrl-M).  To specify any
  2333.       control character, precede the character with a caret (^).  <Enter>
  2334.       would be ^M, which is made up of TWO characters (^ and M) and not by
  2335.       holding down the Ctrl key and hitting M.  You can also cause half
  2336.       second delays within the command entry if necessary by using a tilde
  2337.       (~).  Two tildes equal a 1 second pause.
  2338.  
  2339.      8.2  Sending More Than One Command
  2340.  
  2341.       Use the vertical bar (|) to separate full commands.  If a vertical bar
  2342.       is encountered, a CR (<Enter>) is automatically sent and The Liberator
  2343.       pauses until it one of the eight 'key' prompts defined in the BBS
  2344.       Configuration appear.  You needn't specify ^M before a vertical bar
  2345.       unless you actually want two <Enter>s sent.
  2346.  
  2347.      8.3  Automatically Handled Prompts
  2348.  
  2349.       While sending the commands you define, or while waiting for one of the
  2350.       eight key prompts, the following prompts are automatically handled by
  2351.       The Liberator, if encountered:
  2352.  
  2353.       Prompt             Defined on CFG Screen         Response
  2354.       More (PCBoard)               2                   NS   (non-stop)
  2355.       Scan Message Base            2                   N    (no)
  2356.       Pause                        2                   ^M   <Enter>
  2357.       ProDoor More                 3                   NS   (non-stop)
  2358.  
  2359.       This is useful in case you forget to specify 'NS' (non-stop) in your
  2360.       command, or if you use a J)oin conference command and the 'Scan message
  2361.       base' prompt appears, etc.  Note that the final command must eventually
  2362.       finish at one of the eight 'key' prompts, or The Liberator will not be
  2363.       able to start the next job.
  2364.  
  2365.      8.4  Some Useful Commands
  2366.  
  2367.       The below commands are for use in CC1 or 2, and should be executed on
  2368.       PCBoard v14, or inside a ProDoor where specified.
  2369.  
  2370.       To carry out file oriented commands (commands which normally produce
  2371.       filenames such as F)ile Directories, N)ew Files, L)ocate, or Z)ippy
  2372.       scans), precede the command with "@MakeList <listname>" to have the
  2373.       MakeList script capture all the resulting files, remove extraneous
  2374.       text, and place the result in <listname>.  <Listname> can then be used
  2375.       for downloading in the same session, or saved for later use.  MakeList
  2376.       also allows you to send commands repeatedly in a number of conferences. 
  2377.       See MAKELIST.DOC for more info and some examples... it is a powerful
  2378.       external command and is worth looking into.
  2379.  
  2380.      J <conf>| Precede any of the below commands with this to J)oin a
  2381.                specific conference first (note the vertical bar is used as a
  2382.                command separator).  If sending the command in ProDoor, or if
  2383.  
  2384.  
  2385.  
  2386.  
  2387.      The  L i b e r a t o r  v2.32                  Custom Commands - Page 36
  2388.      
  2389.      
  2390.  
  2391.                conference NAMES are supported on your PCBoard, you may also
  2392.                use the name (e.g. 'IBM' instead of '2').  For example: "J 2
  2393.                Q|R S D" joins conference 2 (note the 'Q' for 'Quiet mode'
  2394.                which suppresses the NEWS bulletin) then sends a message read
  2395.                command as explained below.
  2396.  
  2397.      For the below commands to work properly, Zmodem must be your default
  2398.      PCBoard protocol (set with the PCBoard T)rans. Protocol command), and
  2399.      you must have auto-Zmodem downloads turned on in Telix.  This is due to
  2400.      the fact that Zmodem downloads start automatically.  The Liberator will
  2401.      not start other types of transfers, when requested from Custom Commands.
  2402.  
  2403.      R S D     Read all messages Since the last message read in current
  2404.                conference only, then Download the result.  The file contain-
  2405.                ing the messages will be placed your Download Directory as
  2406.                defined in the BBS Configuration. [Note: You may substitute
  2407.                the 'D' with a 'Z' on PCBoard 14.5 and above, to have the
  2408.                message file compressed before the transfer starts.
  2409.  
  2410.      R Y S D   Same as above, but selects only mail addressed to you.
  2411.  
  2412.      R F Y S D Same as above, but selects messages left by you as well.
  2413.  
  2414.      R A D     Read all messages above the last message last read, in All
  2415.                conferences selected, then Download the result.  Substitute
  2416.                the 'S' in the commands above with an 'A' to scan All
  2417.                conferences selected, instead of just the current conference.
  2418.  
  2419.      ZIPM A|D Z S   To get the extended conferences (older PCBoards
  2420.          support only a limited number of conferences), use this ProDoor
  2421.          command in CC2 to ZIP (compress) messages in all selected conferen-
  2422.          ces, then Download.  Substitute the 'A' after the ZIPM (stands for
  2423.          All selected conferences) with specific conference names/numbers, if
  2424.          desired.  E.g.  ZIPM 1 5 LIBERATE|D S Z scans only conferences 1, 5,
  2425.          and LIBERATE.
  2426.  
  2427.       The below commands are better suited for use with the CapCmd script
  2428.       (explained below) that was included with The Liberator, but you can use
  2429.       them directly as well.  You may also precede the commands below with J
  2430.       <conf>| to Join a specific conference (e.g. J 2 Q|B 2 5 NS):
  2431.  
  2432.      B 2 5 NS  Read bulletins 2 and 5 in NonStop mode.  You should have a
  2433.                Capture File defined in the Command File when this command is
  2434.                used, then simply read the capture file when offline.  To have
  2435.                the bulletins placed in a specific file, use the @CapCmd
  2436.                command, as outlined below.
  2437.  
  2438.      NEWS NS   Re-displays the conference NEWS file in NonStop mode.  This
  2439.                can be useful if you J)oin a conference in Quiet mode or if
  2440.                you used The Liberator's 'Conference to Join at Startup'
  2441.                option, which also uses Quiet mode and suppresses the NEWS
  2442.                display.
  2443.  
  2444.  
  2445.  
  2446.  
  2447.      The  L i b e r a t o r  v2.32                  Custom Commands - Page 37
  2448.      
  2449.      
  2450.  
  2451.      I NS      Display I)ntial welcome in NonStop mode.  Shows the PCBoard
  2452.                version number, and usually contains the board's technical
  2453.                info and system phone numbers.
  2454.  
  2455.      8.5  Running Other Telix Scripts
  2456.  
  2457.       If using the above method of entering the command directly isn't
  2458.       appropriate or possible, you can also call a SALT script for more
  2459.       complicated jobs.  A couple of example scripts were provided for this
  2460.       purpose, and will show you how to get started to create your own simple
  2461.       scripts (also see the SALT tutor (SALT.DOC) included with The Lib-
  2462.       erator).  SALT is not complicated at all, if you ignore the advanced
  2463.       features and make use of the simpler ones.
  2464.  
  2465.       To have a script executed from a Custom Command, simply precede the
  2466.       scripts' filename with '@' (e.g. @SCRIPTNAME).  Note that the extension
  2467.       of the script is not necessary if .SLC is used.  To call the compiled
  2468.       CAPCMD.SLC script, you would use @CAPCMD in a Custom Command.
  2469.  
  2470.      8.6  Passing Parameters To Scripts
  2471.  
  2472.       As well, you can pass 'parameters' (command line options) to the script
  2473.       if it is set up to accept them.  The Liberator separates the rest of
  2474.       the Custom Command line after the @SCRIPTNAME into two portions. 
  2475.       Portion one (parameter 1) is the first 'word' after @SCRIPTNAME, up to
  2476.       the next space.  This is normally used for filenames, since they don't
  2477.       contain spaces.  Portion two (parameter 2) is the rest of the line
  2478.       after the space following parameter 1.  Example:
  2479.  
  2480.       @SCRIPTNAME <parm1_nospace> <parm 2 remainder of line>
  2481.  
  2482.       The CapCmd script included with The Liberator takes two command line
  2483.       parameters like so:
  2484.  
  2485.       @CapCmd <capfname> <command to send>
  2486.  
  2487.       <capfname> being the name of the file you want to use as a temporary
  2488.       capture file, and <command to send> being the actual command to send to
  2489.       PCBoard/ProDoor.  For example, to have this script capture bulletin 6
  2490.       to the file C:\TEMP\B6.CAP, you would use the following Custom Command:
  2491.  
  2492.       @CapCmd C:\TEMP\B6.CAP B 6 NS
  2493.  
  2494.       Or to capture another conference's news file to a file on drive B:
  2495.       called NEWS1.CAP, the Custom Command could be defined like so:
  2496.  
  2497.       J 1 Q@CapCmd B:NEWS1.CAP NEWS NS
  2498.  
  2499.       As you can see above, @SCRIPT need not be the first item in a Custom
  2500.       Command.  However, @SCRIPT must always be the last item, since any text
  2501.       following the script name is separated into parameters, and passed to
  2502.       the script.  Note that no '^M' or '|' followed the J 1 Q command above
  2503.       (^M means <Enter>, | means <Enter> then wait for a 'key' prompt).  This
  2504.  
  2505.  
  2506.  
  2507.  
  2508.      The  L i b e r a t o r  v2.32                  Custom Commands - Page 38
  2509.      
  2510.      
  2511.  
  2512.       is because when '@' is not the first character in the Custom Command,
  2513.       it causes the same effect as a vertical bar, or in other words <Enter>
  2514.       is sent, then we wait for a key prompt before starting the script.
  2515.  
  2516.       Note that CapCmd does NOT automatically handle the prompts outlined
  2517.       above, so make sure you specify Non Stop (NS) in your commands.  CapCmd
  2518.       also does not interpret the special characters ^ ~ @ | as The Liberator
  2519.       does.
  2520.  
  2521.      8.7  Replaceable Parameters?
  2522.  
  2523.       These are very simple and useful.  You can replace either parameter 1
  2524.       or 2, when passing parameters to any script, with:
  2525.  
  2526.       %u  (or %U) which The Liberator then substitutes with the name entered
  2527.           in the 'Upload List' item of the same Command File.  Whatever name
  2528.           is in 'Upload List' is then passed to the script.  If nothing at
  2529.           all is defined in Upload List, then a default name is created in
  2530.           the form <cmd_file_name>.UL.  The actual name of the Command File
  2531.           replaces <cmd_file_name>, .UL stands for Upload List. (E.g. if
  2532.           executing BBSCAP.CMD, the name BBSCAP.UL is used if %u is used as a
  2533.           parameter and no Upload List is defined in the Command File).
  2534.       %d  (or %D) is substituted as above, but with the name defined in the
  2535.           'Download List' item.  If no Download List is defined, a default
  2536.           name is created as outlined above, but with the extension .DL (for
  2537.           Download List).
  2538.  
  2539.       Example: @MakeList %d N S A NS
  2540.  
  2541.       The above would call the script MAKELIST.SLC, sending the name of the
  2542.       current Download List, and the command "N S A NS".  Replaceable
  2543.       parameters can be used when passing parameters to any script.  They are
  2544.       useful when the actual name of the Up/Download List isn't known when
  2545.       you define the Custom Command... for example, if the Up/Download List
  2546.       item is set for interaction with a question mark.
  2547.  
  2548.      8.8  External Script Return Values - IMPORTANT
  2549.  
  2550.       The return value of a called script (sent via the SALT return()
  2551.       statement) is significant, and is tested by The Liberator.  If 0 or 1
  2552.       is returned, the Command File will continue with any other defined
  2553.       jobs, as usual.  Any other value signifies to abort, and causes the
  2554.       Command File to abort disconnect.  This can be useful when programming
  2555.       your own scripts, as you will be able to 'tell' The Liberator to abort
  2556.       the Command File via a return(2); return(3); return(-2); etc.  You can
  2557.       tell The Liberator all went well by either not using a return at all,
  2558.       or by using return; return(0); or return(1); from the main().  The
  2559.       value -1 should never be returned via the return statement, as in SALT
  2560.       this signifies that the called script was not found, or there wasn't
  2561.       enough memory to load it.
  2562.  
  2563.       Whatever value is returned from scripts called via Liberator Custom
  2564.       Commands is stamped in the usage log, for later reference.
  2565.  
  2566.  
  2567.  
  2568.  
  2569.      The  L i b e r a t o r  v2.32                   File Transfers - Page 39
  2570.      
  2571.      
  2572.  
  2573.                                 9.  FILE TRANSFERS
  2574.  
  2575.  
  2576.      The Liberator can transfer files in any of six ways, depending on the
  2577.      BBS.  The slow, plain old PCBoard uploads and downloads are supported on
  2578.      any BBS, and will be used where nothing else is available.  PCBoard
  2579.      'batch' uploads and downloads can be taken advantage of for extra speed,
  2580.      if your BBS supports them.  Batch transfers are discussed in the
  2581.      sections 'What are Protocols?' and 'Setting Up PCBoard'.  As well,
  2582.      ProDoor batch uploads and downloads can also be carried out, if your BBS
  2583.      has a ProDoor.  You can even have The Liberator count the number of
  2584.      files on your lists and make a decision whether to OPEN the ProDoor, or
  2585.      carry the transfer out on PCBoard.
  2586.  
  2587.      9.1  Sending Files (Uploading) To PCBoard
  2588.  
  2589.       To have file uploaded, you create a list of filenames with your Text
  2590.       Editor (Text Editors are described above in the section 'Installing The
  2591.       Liberator', if you don't know what they are), by typing the filename
  2592.       and description in, pretty much as you would do when you were on
  2593.       PCBoard.  Each file you want to upload is specified along with a
  2594.       description on the SAME line.  One file/description per line.  For long
  2595.       multi-line descriptions, if supported on your BBS, you may enter up to
  2596.       500 characters per line... but do not use more than one line per
  2597.       description.
  2598.  
  2599.       There is no limit as to the number of files you can place on your File
  2600.       Lists.  The Liberator will transfer as many files as you have time for,
  2601.       and will automatically remove files from your list after the transfer
  2602.       is carried out successfully!  Any files that are not transferred are
  2603.       left on the list for next time (sometimes The Liberator 'comments out'
  2604.       lines in your list... this is explained below).  A line from an Upload
  2605.       List might look like this:
  2606.  
  2607.       LIB232.ZIP The Liberator PCBoard Automation System.
  2608.  
  2609.       This line would cause The Liberator to search in the defined Upload
  2610.       Directory (defined in each Configuration on screen 1) for the file
  2611.       LIB232.ZIP, and if found, the upload request is sent to the BBS.  If
  2612.       the BBS gives the okay, the description "The Liberator PCBoard
  2613.       Automator for Telix." is entered, and the transfer is started when
  2614.       prompted.
  2615.  
  2616.      9.2  Comments On File Lists (//)
  2617.  
  2618.       Lines can also be 'commented out' of your list, which means they are
  2619.       ignored, by using two forward slashes (//) at the beginning of the
  2620.       line.  You may use this feature to place permanent comments in your
  2621.       lists, or to temporarily remove filenames without actually deleting the
  2622.       line from your list.  The Liberator itself sometimes inserts "//
  2623.       (error)" at the beginning of a line to comment out a file, depending on
  2624.       the error that occurred when attempting the transfer. (Error) is
  2625.       substituted with the actual reason that the line was commented out. 
  2626.  
  2627.  
  2628.  
  2629.  
  2630.      The  L i b e r a t o r  v2.32                   File Transfers - Page 40
  2631.      
  2632.      
  2633.  
  2634.       Comments remain on the list permanently, and should be removed manually
  2635.       when necessary.  Lines that start with a space, or a vertical bar (|)
  2636.       are also treated as comments, but these lines are removed from the list
  2637.       when encountered.
  2638.  
  2639.      9.3  Optional File List Items (Switches)
  2640.  
  2641.       You can also add other items to each line if you have special needs,
  2642.       such as joining specific conferences, specifying an upload or download
  2643.       password, or if you don't want the line removed from the list when the
  2644.       transfer is successfully carried out.  As well, you may specify a drive
  2645.       and/or directory path if the file is not located in your Upload
  2646.       Directory as defined in the BBS Configuration being used.  The full
  2647.       format for each line is:
  2648.  
  2649.       [/u-|/d-pass][/#nnn][/P] [d:][\path\]FILENAME[.ext] <Description> 
  2650.  
  2651.       The items in square brackets simply denote optional items, and the
  2652.       square brackets should not actually be included if you use these items. 
  2653.       The vertical bar (|) means to use one or the other (either a /u-pass or
  2654.       /d-pass... subtitute 'pass' with a password).  The filename must be
  2655.       separated from other items on the line by at least one space.  Switches
  2656.       may appear in any order, and can be separated by a space if desired,
  2657.       but '/' must be the *first* character on the line for switches to be
  2658.       recognized.  Switches must precede the filename, or they will not take
  2659.       effect, and will be considered as part of the <Description>.  All of
  2660.       the optional items are explained below, in the same order as they
  2661.       appear on the line above.
  2662.  
  2663.      9.4  Specifying Upload or Download Passwords (/u /d)
  2664.  
  2665.       Some PCBoards require entry of a specific password before uploading or
  2666.       downloading.  If a specific file, or all files on your File List
  2667.       requires the entry of a password in order to send or receive the file,
  2668.       use the /u switch for Upload passwords, or the /d switch to specify
  2669.       Download passwords.  When the switch is found, the password following
  2670.       the switch stored in memory and will be entered if the 'Password'
  2671.       prompt, defined on CFG screen 2, appears when entering a filename.  Any
  2672.       character other than a space or tab may be used to separate the switch
  2673.       from the password (/u=pass /u:pass, etc.)  Use whichever character you
  2674.       prefer.
  2675.  
  2676.      9.5  Joining Specific Conferences (/#nnn)
  2677.  
  2678.       '/#nnn' is an optional conference to join before uploading the file. 
  2679.       Substitute 'nnn' with the actual conference number. Conference NAMES
  2680.       may also be used if supported where you are performing the transfer.
  2681.       ProDoor supports conference NAMES, and some newer PCBoards do as well
  2682.       (e.g. /#IBM).  All files below, and including the line with the /#
  2683.       switch are uploaded to the specified conference (you need not specify
  2684.       the switch again, until you want to join a different conference).  If
  2685.       you ALWAYS join a specific conference before uploading or downloading
  2686.       files, rather than place a /# in your File List each time, specify the
  2687.  
  2688.  
  2689.  
  2690.  
  2691.      The  L i b e r a t o r  v2.32                   File Transfers - Page 41
  2692.      
  2693.      
  2694.  
  2695.       conference in the 'Conference to Join at Startup' option on CFG screen
  2696.       1 of the appropriate Configuration.
  2697.  
  2698.       Once a /# switch is used, The Liberator keeps the current conference in
  2699.       memory, and will not re-join the same conference if the same switch is
  2700.       specified again, while still in this conference.  As well, the con-
  2701.       ference is not joined until a valid filename is found on the list.  If
  2702.       /# is specified, and no valid filenames follow, the conference will not
  2703.       be joined.
  2704.  
  2705.      9.6  Making File List Items Permanent (/P)
  2706.  
  2707.       The '/P' switch causes the line on which it is found to be 'permanent'. 
  2708.       Usually, once a file is successfully up/downloaded, the line is
  2709.       automatically removed from the list to avoid duplicate up/downloads the
  2710.       next time the list is used.  Other switches, and lines starting with a
  2711.       blank (space or tab) or (|) are also normally removed when encountered. 
  2712.       To override this, use the /P switch, and the line will remain on the
  2713.       list.  This can be useful when you wish to upload the same file, using
  2714.       the same File List, to multiple BBS's, or keep a switch permanently on
  2715.       your list (e.g. /#2 /P).  /P can be used for Download Lists as well. 
  2716.       Note that lines starting with the comment switch (//) also are con-
  2717.       sidered permanent, and must be removed manually.  Comments may also be
  2718.       placed after other switches:  /u-Mypassword // This is a comment.
  2719.  
  2720.      9.7  Using Switches On Separate Lines
  2721.  
  2722.       All the switches listed above can be used by themselves on a line which
  2723.       does not specify a filename, if desired.  As mentioned above, the /u
  2724.       and /d switches are read then stored in memory for use if the 'Pass-
  2725.       word' prompt appears.  When a /# switch is encountered it is stored in
  2726.       memory and will take effect for the next valid file.  The /P switch, if
  2727.       used without a filename causes the current line, along with the current
  2728.       conference, to remain on the list.  For example:
  2729.  
  2730.      /#2
  2731.      // (file not found) FILENAME.EXT This file was removed earlier
  2732.       This is an invalid line because of the leading space
  2733.      /u=up-password // This is the upload password
  2734.      /P
  2735.      NOEXIST.ZIP File does not exist
  2736.      | This line is ignored because of the vertical bar
  2737.  
  2738.       If the above were your entire Upload List, conference 2 would not be
  2739.       joined since no valid filenames follow the request.  Only once a valid
  2740.       filename was found, would conference 2 be joined.  The /P switch, if
  2741.       specified on a line without a filename, causes the current conference
  2742.       to be placed permanently on the list, at that position.  Once The
  2743.       Liberator had processed the above Upload List, it would look like this:
  2744.  
  2745.      // (file not found) FILENAME.EXT This file was removed earlier
  2746.      // This is a comment (lines starting with // are never removed)
  2747.      /u=up-password // This the upload password
  2748.  
  2749.  
  2750.  
  2751.  
  2752.      The  L i b e r a t o r  v2.32                   File Transfers - Page 42
  2753.      
  2754.      
  2755.  
  2756.      /#2 /P
  2757.      // (file not found) /#2 NOEXIST.ZIP File does not exist
  2758.  
  2759.       Note how the current conference is also placed with a file, if it
  2760.       removed with an // (error).  This occurs with any file that is removed,
  2761.       to ensure that the proper conference is not lost, should you rearrange
  2762.       the list later.
  2763.  
  2764.      9.8  Specifying A Drive/Directory
  2765.  
  2766.       [d:][\path\]FILENAME[.ext] is an optional drive, path and extension,
  2767.       which can be specified for any file on your Upload List, if the file is
  2768.       not located in the Upload Directory specified in the Configuration.  If
  2769.       the file is not found in the directory specified, The Liberator will
  2770.       then search the defined Upload Direcory, and upload the file if it is
  2771.       found there.  No particular extension is assumed, and if you do not add
  2772.       an extension, The Liberator will simply add a period (.) as the
  2773.       extension.  The . is added since ProDoor usually adds a 'default'
  2774.       extension [.ZIP, etc.] if no period follows the filename, which may
  2775.       cause an error locating the file.
  2776.  
  2777.      9.9  Upload Descriptions
  2778.  
  2779.       <Description> should be replaced with a description of the file you are
  2780.       uploading.  When online, The Liberator enters the description character
  2781.       by character, just as if you were typing it yourself (but perhaps
  2782.       faster).  The description isn't typed in as fast as other respones,
  2783.       since The Liberator pauses (for 1/10 of a second) and checks whether
  2784.       the description has 'overflowed' after entering each character.  If you
  2785.       are performing the upload in ProDoor, or on a PCBoard that supports
  2786.       multi-line upload descriptions, don't concern yourself with what text
  2787.       will end up on what line.  The BBS itself will take care of this using
  2788.       'word wrapping' within the margins, much like your word processor does. 
  2789.       The Liberator simply enters all the characters you give in the descrip-
  2790.       tion (the entire description MUST be specified on the same line in your
  2791.       Upload List... up to 500 characters per line are permitted), and the
  2792.       BBS takes care of line-wrapping.  You may force text to the next
  2793.       description line by using ^M (two characters... ^ and M) in your
  2794.       description.  It is *not* necessary to use ^M's to move to the next
  2795.       description line though.
  2796.  
  2797.       When creating your Upload List, if your text editor keeps wrapping your
  2798.       descriptions to the next line, look for a way to set the margins.  Set
  2799.       the margins to 0 left 500 right if possible, or simply to the maximum
  2800.       width within 500 characters.  The description you give must be at least
  2801.       15 characters in length, or The Liberator will not attempt the upload,
  2802.       and will automatically 'comment out' the line from your list.  The
  2803.       minimum description limit on PCBoard was 10 characters at release date,
  2804.       but ProDoor has a minimum of 15 so I used this number to keep things
  2805.       consistent (PCBoard usually follows ProDoor in any case, and will
  2806.       probably increase its 10 char. minumum in the future).
  2807.  
  2808.  
  2809.  
  2810.  
  2811.      The  L i b e r a t o r  v2.32                   File Transfers - Page 43
  2812.      
  2813.      
  2814.  
  2815.       If the description is too long and overflows (each BBS may be set up to
  2816.       accept a different number of characters for a description), The
  2817.       Liberator will stop sending characters and attempt to backspace over
  2818.       any that overflowed.
  2819.  
  2820.      9.10  Backup Lists
  2821.  
  2822.       Before your original File List is modified, it is copied to a file of
  2823.       the same root name, but with the extension .BAK.  For example, if the
  2824.       Upload List was called TEST.UL, you could find the list in its original
  2825.       condition in TEST.BAK.  This also applies to Download Lists.
  2826.  
  2827.      9.11  Demonstration Upload List
  2828.  
  2829.       To demonstrate how to upload to a BBS, I'll assume you found a PCBoard
  2830.       that doesn't have The Liberator v2.32 in its library, and that you want
  2831.       to help me distribute the program, so are going to have the program
  2832.       automatically upload itself (how's THAT for assumptions...).
  2833.  
  2834.       An Upload List to automatically upload The Liberator was provided, and
  2835.       will also use multiple-line descriptions if available on the BBS.  All
  2836.       you have to do is 'Create' or 'Edit' a Command File from the main menu
  2837.       and include the name LIB232.UL (and drive/path if not in the current
  2838.       directory) in the 'Upload List' option of the Command File.  Of course,
  2839.       before use it does require you to have the file LIB232.ZIP in your
  2840.       Upload Directory.  Sorry about that... it's one of the things I
  2841.       couldn't take care of automatically.
  2842.  
  2843.       For example, assuming the Upload List itself (LIB232.UL) was in the
  2844.       C:\TELIX Directory, you would enter "C:\TELIX\LIB232.UL" (without the
  2845.       quotes) in the Upload List option of an appropriate Command File, then
  2846.       copy LIB232.ZIP into your Upload Directory.  The Upload List can then
  2847.       be used as many times as necessary, since the /P switch is specified
  2848.       along with the filename.  Load the file LIB232.UL into your Text
  2849.       Editor, and set the margins to 0 left 500 right (or as wide as
  2850.       possible) to edit the file, if necessary.  Some further instructions
  2851.       and information were placed directly in the file, to help you get
  2852.       familiar with automated uploading.
  2853.  
  2854.      9.12  Telix Batch Upload Limitation
  2855.  
  2856.       Note that when performing batch uploads, each filename in the batch is
  2857.       separated by a space, and passed to Telix on one line in order to carry
  2858.       out the upload itself (e.g. FILE1.ZIP FILE2.ZIP FILE3.ZIP).  However,
  2859.       from SALT scripts, there is a limit of 64 characters for the entire
  2860.       batch of filenames.  This means that only about 3 or 4 filenames can be
  2861.       specified at once for batch uploads... enough filenames to fill the 64
  2862.       character limit.  You needn't let this concern you, since The Liberator
  2863.       keeps track of how many characters are already in this line, and will
  2864.       stop entering names and transfer the batch when a filename is too big
  2865.       to fit within the 64 character limit.  A new batch is then started
  2866.       until filenames fill up the 64 character limit again.  This continues
  2867.       until the list is complete or you run out of time.  The 64 character
  2868.  
  2869.  
  2870.  
  2871.  
  2872.      The  L i b e r a t o r  v2.32                   File Transfers - Page 44
  2873.      
  2874.      
  2875.  
  2876.       limit is mentioned only for your interest, in case you wondered why not
  2877.       as many files are entered in a batch when uploading.
  2878.  
  2879.      9.13  Receiving Files (Downloading) From PCBoard
  2880.  
  2881.       Downloads are performed much like uploads, but a description need not
  2882.       be entered along with the filename.  Any characters following the first
  2883.       space after the filename are ignored in Download Lists.  The same
  2884.       switches apply for joining a conference, or specifying permanent lines,
  2885.       as outlined above for Upload Lists.  Use your Text Editor, the MakeList
  2886.       script, or a program that copies lines from one text file to another,
  2887.       such as Vernon Buerg's LIST.COM, to create your Download Lists.  Once
  2888.       the list is created, you simply supply the list's location/filename in
  2889.       the 'Download List' option of any Command File to have the downloads
  2890.       carried out (e.g. C:\TELIX\DOWNLOAD.LST)
  2891.  
  2892.      9.14  Using LIST.COM to create Download Lists
  2893.  
  2894.       If you obtain, or are currently using Vern Buerg's LIST v6.4a or
  2895.       greater, you can read PCBoard file listings quickly and easily -- and
  2896.       create a Liberator Download List at the same time.  Complete file
  2897.       listings can be downloaded from most BBSes, and contain all the files
  2898.       in a specific file area, or all the files on the BBS.  As well, Mail
  2899.       Doors such as the Qmail Door can be set up to send new files listings
  2900.       along with a message packet.  In Deluxe, you use the A)rchive New Files
  2901.       command to save the entire new files list to a file called <packet-
  2902.       id>.NEW, which can be browsed with LIST to create a Download List.  You
  2903.       can also use the MakeList script along with a F)ile Directories, N)ew
  2904.       Files, L)ocate, or Z)ippy Scan command to capture file listings (see
  2905.       MAKELIST.DOC for info).
  2906.  
  2907.       With LIST, you can view PCBoard listings using the up/down arrow,
  2908.       PgUp/PgDn, Home/End cursor keys.  Then, when you see a file you want to
  2909.       place on your Download List, mark the line by moving it to the top of
  2910.       the screen then hitting <Alt-M>, or the bottom of the screen then
  2911.       hitting <Alt-B>.  If several consecutive lines are to be marked,
  2912.       perform a second <Alt-M> or <Alt-B> on the last line in the series. 
  2913.       Marked lines will be marked in reverse video.
  2914.  
  2915.       Then dump the line(s) to your Download List by typing <Alt-D>.  For the
  2916.       first line(s) dumped, you must enter the name of your Download List
  2917.       (LIST always prompts for a filename when <Alt-D> is pressed).  From
  2918.       this point on, you then use <Alt-O> to dump, which means to 'dump to
  2919.       the last filename used'.  Using this method will ensure that, a) the
  2920.       filename is spelled correctly and, b) that the file actually exists on
  2921.       that board.  Not to mention that it is easier than typing the names
  2922.       manually!
  2923.  
  2924.  
  2925.  
  2926.  
  2927.      The  L i b e r a t o r  v2.32                 Using The Master - Page 45
  2928.      
  2929.      
  2930.  
  2931.                                10.  USING THE MASTER
  2932.  
  2933.  
  2934.       The Master itself is very simple.  It's just a list of Command File
  2935.       names that you create with Add and Remove on the main menu.  This list
  2936.       is processed by the RunMaster script to run multiple Command Files in a
  2937.       number of different ways.  The Command Files defined on the Master list
  2938.       can be executed on the same BBS without disconnecting, for a 'linked'
  2939.       type job, on a variety of BBS's, without intervention.  The Master is a
  2940.       very powerful feature if used to its full extent.  Some example
  2941.       scenarios and uses for the Master are covered below.
  2942.  
  2943.      10.1  Creating a Master
  2944.  
  2945.       First, you must have at least two Command Files that actually do
  2946.       something.  The Master does not accept interactive options (they are
  2947.       automatically turned 'off' when the Master is running, and does not
  2948.       allow a Command File to remain online at completion, so you can't use
  2949.       the logon script we created above since, with disconnect enabled, it
  2950.       doesn't do anything but logon then logoff...  The reason interactive
  2951.       options are automatically disabled, and disconnect enabled, is that it
  2952.       is assumed you will not be present when you run the Master, and thus
  2953.       would not be able to provide input for these items.  If you plan to be
  2954.       present, you may simply select the Command Files from the Command File
  2955.       Manager.
  2956.  
  2957.       If you don't yet have at least two Command Files setup to do real jobs
  2958.       then you aren't in need of a Master yet and can return here later.
  2959.  
  2960.      10.2  Using the Add Option
  2961.  
  2962.       The main menu Add option is used to create or add to the Master.  When
  2963.       you select Add, you can add one of four things: a Command File, a Delay
  2964.       time, an EXIT command, or a REPEAT command.
  2965.  
  2966.       To add a Command File, simply type its entry number as displayed on the
  2967.       menu.  To add a Delay time, which allows you to pause execution of
  2968.       specific Command Files until a specific time, enter a 'D', then enter
  2969.       the desired time.  The time is expected in 24 hour format, so 00:00 is
  2970.       midnight, 12:00 is noon, and you just add 12 to PM times (e.g. 1pm + 12
  2971.       = 13:00).  To enter an EXIT command, which causes The Liberator to exit
  2972.       to DOS thereby ending execution of the Master list, enter an 'E'.  To
  2973.       enter a REPEAT, which causes all Command Files to be placed back in the
  2974.       queue (explained below) and the list to be re-started, enter an 'R'.
  2975.  
  2976.       Once you choose what you wish to Add, all these items can be placed at
  2977.       any position on the Master list.  When you enter your selection, you
  2978.       will be prompted to hit <Enter> to append the selected item, or <Alt-I>
  2979.       to insert it at another position.  If you hit <Enter>, the item is
  2980.       added to the end of the Master.  If you hit <Alt-I> (Insert), the
  2981.       Master is displayed and you are asked which position to insert the item
  2982.       into.  If you type a number, the item is placed into that entry, and
  2983.       other entries are pushed down by one entry.
  2984.  
  2985.  
  2986.  
  2987.  
  2988.      The  L i b e r a t o r  v2.32                 Using The Master - Page 46
  2989.      
  2990.      
  2991.  
  2992.      10.3  Using the Remove Option
  2993.  
  2994.       To remove any item on the Master list, select the main menu Remove
  2995.       option.  Once selected, the Master will be displayed and you simply
  2996.       enter the number beside the item you wish to remove.  You then have the
  2997.       option of removing a sequence of entries, or just the one entered.  Hit
  2998.       <Enter> to remove just the one entered, or type another number and all
  2999.       entries between and including the numbers entered will be removed.
  3000.  
  3001.      10.4  Running the Master
  3002.  
  3003.       You can run the Master in two ways.  From the Command File Manager,
  3004.       simply select entry '0' as you would to run a Command File.  You may
  3005.       also execute the RunMaster script directly as you would run any other
  3006.       script: type <Alt-G> then enter RUNMASTR from within Telix, or simply
  3007.       type RUNMASTR from DOS to execute the RUNMASTR.BAT file that was
  3008.       created by the installation program.  Note that RUNMASTR.BAT simply
  3009.       types in "Telix sRunMastr" for you.  You can run any Telix script from
  3010.       DOS in this manner, by preceding the script name (in this case,
  3011.       RUNMASTR.SLC), with the letter 's'.  The .SLC extension is assumed by
  3012.       Telix and isn't necessary.
  3013.  
  3014.       When RunMaster starts, it will display the Master list and prompt you
  3015.       for an entry number to start at.  If you don't enter a response within
  3016.       15 seconds (if you aren't present), or if you hit <Enter>, the Master
  3017.       starts at entry 0 and continues until the end, or until an EXIT or
  3018.       REPEAT command is reached.  If an EXIT is reached, RunMaster ends and
  3019.       exits to DOS, or back to the calling program/batch file.  If a REPEAT
  3020.       is encountered, the Master is re-started wherever it was originally
  3021.       started.  So if you started at entry 20, RunMaster would go back and
  3022.       rerun every job from 20 back to the REPEAT.  This is useful when you
  3023.       will be away for a number of days, etc., and is normally used in tandem
  3024.       with one or more Dialing delay times.  REPEAT continues to re-run the
  3025.       jobs indefinitely, until you manually abort by hitting <Esc>.
  3026.  
  3027.      10.5  Using EXIT and REPEAT to Create Multiple Masters
  3028.  
  3029.       Since you can start the Master at any position, and since both EXIT and
  3030.       REPEAT commands cause the current Master run to end or restart when
  3031.       encountered, you can actually create many different runs using only one
  3032.       Master.  For an example of this, look at the Master below:
  3033.  
  3034.      0  CMD1
  3035.      1  CMD2
  3036.      2  CMD3
  3037.      3  *EXIT*
  3038.      4  *12:00*
  3039.      5  CMD1
  3040.      6  CMD4
  3041.      7  *REPEAT*
  3042.      8  CMD5
  3043.      9  CMD3
  3044.  
  3045.  
  3046.  
  3047.  
  3048.      The  L i b e r a t o r  v2.32                 Using The Master - Page 47
  3049.      
  3050.      
  3051.  
  3052.       There is a possibility of many different runs using the above Master. 
  3053.       If you tell RunMaster to start at entry 0 (the default), then CMD1,
  3054.       CMD2 and CMD3 are executed, then we exit to DOS, which ends the Master
  3055.       run.  If you tell RunMaster to start at entry 4, all jobs are delayed
  3056.       until 12 noon.  At noon CMD1 and CMD4 execute, then the REPEAT is en-
  3057.       countered which causes the Master to repeat at its STARTING point...
  3058.       which was entry 4: the dialing delay.  So, that's another run with CMD1
  3059.       and CMD4 being executed repeatedly at 12 noon each day.  If you start
  3060.       at entry 8, CMD5 and CMD3 are carried out, then the Master completes
  3061.       and returns to Telix, or the calling SALT script (the Command File
  3062.       Manager, or a script of your own).  As well, you could start at entry 1
  3063.       to have just CMD2 and CMD3 carried out, etc.  The possibilities are
  3064.       almost endless.
  3065.  
  3066.      10.6  The Master Queue
  3067.  
  3068.       When the Master starts execution, all jobs to be run are placed in a
  3069.       'queue'.  The queue keeps track of the Command Files that have not
  3070.       completed successfully -- initially all of them.  Each Command File in
  3071.       the queue will be dialed for the total number of attempts, as defined
  3072.       in each Configuration in the 'Redial attempts' item (0 = until connect,
  3073.       as usual).  However, rather than dialing each job for its total redial
  3074.       attempts all at once, RunMaster also adds a 'Master redial attempts',
  3075.       which causes each job to be dialied only a few times, then, if a
  3076.       connection is not established, cycle on to the next job.  The
  3077.       unsuccessful job is left in the queue to be tried again later, and the
  3078.       running total of attempts is incremented each time the job is tried. 
  3079.       'Master redial attempts' is initially set to 3, and is set with the
  3080.       'Tools' Configure option.
  3081.  
  3082.       Assuming the Master redial attempts is set to 3, job 1 was set to
  3083.       redial 5 times only and all others were set to '0' (until connect), the
  3084.       current time is 11am, and you started the example Master below at entry
  3085.       0, here is an illustration of how the queue behaves:
  3086.  
  3087.      0  CMD1
  3088.      1  CMD2
  3089.      2  *12:00*
  3090.      3  CMD3
  3091.      4  *EXIT*
  3092.  
  3093.       At startup, all jobs, including the Delay time and the EXIT, are placed
  3094.       in the queue.  The first job in the queue (CMD1) will be dialed 3 times
  3095.       (3 because of the Master redial attempts), and if no connection is
  3096.       established, the next job in the queue is dialed 3 times.  If no
  3097.       connection is established on CMD2, we then run into the Dial delay, but
  3098.       it's only 11:02am.  Will we now just sit here until Noon, leaving CMD1
  3099.       and CMD2 in limbo?  I hope not... RunMaster is smarter than that!  CMD3
  3100.       will not start until 12:00, since it is after the Delay time, but if
  3101.       other jobs are still in the queue up until that time, they are tried
  3102.       repeatedly until they complete successfully.  [If 12 noon is reached,
  3103.       and CMD1 and CMD2 are still in the queue, RunMaster simply starts
  3104.       trying all three of them from 12 noon on].
  3105.  
  3106.  
  3107.  
  3108.  
  3109.      The  L i b e r a t o r  v2.32                 Using The Master - Page 48
  3110.      
  3111.      
  3112.  
  3113.       If the job CMD1 is dialed a second time, and no connection is
  3114.       established, it will be removed from the queue, since it's 'Redial
  3115.       attempts' was assumed to be set to 5... and after 2 tries by RunMaster,
  3116.       the job would have been tried a total of 6 times (3 the first, 3 the
  3117.       second).  As soon as the running total for each job reaches the 'Redial
  3118.       Attempts' set in the Configuration, the job is removed from the queue. 
  3119.       If Redial attempts is set to 0, the job remains in the queue until
  3120.       completed or until it aborts due to an error.
  3121.  
  3122.       Okay, now lets assume job CMD1 is gone, since the redials expired, CMD2
  3123.       was tried and tried again (it is set to dial until it connects), and 
  3124.       at 11:45 we finally get connected and carry out CMD2, but the session
  3125.       takes longer than expected... CMD2 finishes successfully and is removed
  3126.       from the queue, but it's now 12:30!  The 12 noon delay has already
  3127.       passed, so does RunMaster wait until 12 noon the next day?  No. 
  3128.       RunMaster has planned for just such an occasion.  Delays are good for
  3129.       up to one hour after the specified time, to allow for overruns as il-
  3130.       lustrated above.  If CMD2 had executed until 1:01, then the delay would
  3131.       be activated, and RunMaster would wait until 12 noon the next day.
  3132.  
  3133.       Once the Delay time has passed, it is also removed from the queue, then
  3134.       we start trying CMD3... and get 3 busy signals and run straight into
  3135.       that *EXIT*.  Do we now exit to DOS?  No.  RunMaster also watches for
  3136.       this type of disaster.  *EXIT* and *REPEAT* commands only take effect
  3137.       once the queue is empty.
  3138.  
  3139.       Above, it was assumed that the jobs that did get connected actually
  3140.       completed successfully, but what if they didn't?  If you take a peek at
  3141.       the section 'Abort Codes/Remedies' at the end of the manual, you'll see
  3142.       that The Liberator keeps very good track of errors that occur, and
  3143.       actually returns a different value, called an Abort Code, for each
  3144.       error.  RunMaster checks this number and determines whether to remove
  3145.       the Command File or not.
  3146.  
  3147.       If a -1 is returned, the entire Master is aborted, since this means
  3148.       Number One (LIBERATE.001) couldn't be found, or there wasn't enough
  3149.       memory to load it... Number One carries out all the Command Files, so
  3150.       it would be pretty hopeless trying other jobs.  If a zero, or any value
  3151.       up to 26 is returned, the Command File is removed from the queue, since
  3152.       re-running the job after any of these return values would not be ap-
  3153.       propriate.  If 27 is returned (operator abort), then the Master Control
  3154.       Menu is called up to allow you to determine what to do next (the menu
  3155.       is self-explanatory, and if you see it you'll know what to do).
  3156.  
  3157.       If 28 is returned, which means 'connection lost', or 29 which means the
  3158.       logon was bad (you got connected to a bad node, etc), then the Command
  3159.       File remains in the queue.  These two return values are closely watched
  3160.       however, to avoid re-connecting to a BBS for hours on end.  If 3 of
  3161.       these return values are returned from the same Command File consecu-
  3162.       tively, the file is removed from the queue.  Of course if value 30 is
  3163.       returned, which means 'unable to establish a connection' (busy
  3164.       signals), then the file is left in the queue to be tried again. 
  3165.       Between each successful Command File, all jobs in the queue starting
  3166.  
  3167.  
  3168.  
  3169.  
  3170.      The  L i b e r a t o r  v2.32                 Using The Master - Page 49
  3171.      
  3172.      
  3173.  
  3174.       from the beginning are tried again, to maximize your chances of getting
  3175.       onto a busy BBS.
  3176.  
  3177.      10.7  Using the Master To Link Command Files
  3178.  
  3179.       What if you have the Master below setup, and the files that start with
  3180.       BBS1 use a Configuration that is set up to call one BBS, while the
  3181.       files that start with BBS2 are setup to call another?
  3182.  
  3183.      0  BBS1-1
  3184.      1  BBS2-A
  3185.      2  BBS1-2
  3186.      3  BBS2-B
  3187.      4  BBS1-3
  3188.      5  *04:00*
  3189.      6  BBS1-4
  3190.  
  3191.       Before RunMaster passes a job to LIBERATE.001 (the script which runs
  3192.       all your Command Files), it first gets the Telix dialing directory
  3193.       entry numbers you defined in the Command File's accompanying BBS
  3194.       Configuration, and checks all other jobs in the master queue (up to a
  3195.       REPEAT or EXIT) for BBS Configurations with at least one of the same
  3196.       entry numbers defined.  If it finds another job with a CFG that has an
  3197.       entry number the same (assumed to be carried out on the same BBS), it
  3198.       instructs LIBERATE.001 NOT to disconnect when the Command File
  3199.       completes.  Thus, no matter which Command File in the Master above gets
  3200.       connected first, the other Command Files for the same BBS will be
  3201.       executed without disconnecting.  For example, if BBS1-3 got connected
  3202.       first (entry 4), then RunMaster will have already found that BBS1-1
  3203.       (entry 0) was to be executed on the same BBS, and instructed Number One
  3204.       not to disconnect.
  3205.  
  3206.       When entry 4 completes, entry 0 will be executed, then entry 2, since
  3207.       it is also set up for the same BBS.  Entry 6 is only started without
  3208.       disconnecting if it is between 4 and 5 AM (note the *04:00* Delay time
  3209.       above).  Otherwise, we finally disconnect from BBS1 and start executing
  3210.       the BBS2 series.  If all BB2 Command Files finish before 04:00, then a
  3211.       delay window (menu) will be displayed on the screen until 4am.  You can
  3212.       select a number of options from this window, or even Shell to DOS until
  3213.       the Delay time is reached, if you are present at the time.  If any jobs
  3214.       are still in the queue at 4am, then the delay is removed from the
  3215.       queue, and entry 6 joins in on the dialing.  So, you needn't worry
  3216.       about placing the files in any specific order and attempt to fumble
  3217.       with the Disconnect option for Master entries.  Just Add entries as you
  3218.       like, and RunMaster will sort everything out for you!
  3219.  
  3220.      10.8  Command File Differences Under RunMaster
  3221.  
  3222.       Command Files behave differently when the Master is running, since it
  3223.       is assumed you are not present when the each job is started (if you
  3224.       plan to be present, you can start each job yourself and don't need the
  3225.       Master). 
  3226.  
  3227.  
  3228.  
  3229.  
  3230.      The  L i b e r a t o r  v2.32                 Using The Master - Page 50
  3231.      
  3232.      
  3233.  
  3234.       The 'Display Command File Delay' set in the main configuration is
  3235.       temporarily set to zero, to avoid a delayed display screen.  As
  3236.       explained above, the 'Master redial attempts' is used instead of the
  3237.       usual 'Redial attempts' set in each BBS Configuration.  As well, any
  3238.       'Dial Starting Time' set in the Command File itself is set to 'Now'
  3239.       (use the Master Dial delays to set Master starting times) and any
  3240.       Command File items set for interactive response are turned off.  As
  3241.       explained above, the disconnect option is controlled by RunMaster, so
  3242.       you needn't worry about changing this for the Master.
  3243.  
  3244.  
  3245.  
  3246.  
  3247.      The  L i b e r a t o r  v2.32              Configuring Prompts - Page 51
  3248.      
  3249.      
  3250.  
  3251.                         11.  CONFIGURING LIBERATOR PROMPTS
  3252.  
  3253.  
  3254.      If The Liberator gives you the message << Unable to locate a recog-
  3255.      nizable prompt >>, or if some operation fails, such as a file transfer
  3256.      is not started when prompted, then either The Liberator is sending
  3257.      responses too fast and you must set a 'Response Delay' or the PCBoard/-
  3258.      Door is not using the standard prompts (or is using old/very new
  3259.      versions of these programs) and you must tell The Liberator the format
  3260.      of the prompt being used.  (Keep the response delay in mind if you check
  3261.      the prompt and find out that it matches what The Liberator was looking
  3262.      for.)
  3263.  
  3264.      To check for a bad prompt, refer to your capture file (if still in Telix
  3265.      you can also check the scrollback buffer with <Alt-B>) to see where the
  3266.      problem occurred.  Take a good look at where the session failed and
  3267.      write down the last prompt/message exactly, including all spaces and
  3268.      punctuation (case is not important).  To illustrate, let's assume the
  3269.      first name prompt had been changed to the format below, and was not
  3270.      recognized:
  3271.  
  3272.      Please enter your Name now:
  3273.  
  3274.      You would first write down the above text, including the colon, as soon
  3275.      as it was found that this is where the program failed.  Next, start The
  3276.      Liberator, select 'Edit' then <Alt-E>, and select the appropriate BBS
  3277.      Configuration from the menu.  Once the CFG file is loaded, since this
  3278.      was a PCBoard prompt, you would move to screen 2, the PCBoard Prompts
  3279.      screen, by hitting <Down arrow>.  If the program had failed at a
  3280.      ProLogon, ProBank, or Prodoor prompt, you would move to screen 3.  If it
  3281.      failed in the Mail Door, you would move to screen 4.
  3282.  
  3283.      Once at the proper screen, view the prompt descriptions and select the
  3284.      prompt that needs changing.  They are all fairly self-explanatory.  For
  3285.      the example above, prompt 3 'Name', on the PCBoard Prompts screen would
  3286.      be what needed changing.  If the defined prompt looks the same as what
  3287.      the BBS sent, go back to screen 1 and try setting a Response delay of 5
  3288.      or 10 in option 4.  In this example, you would see that The Liberator
  3289.      expects the prompt in the standard format of:
  3290.  
  3291.       First name? <<
  3292.  
  3293.      (Note the << is used to show trailing spaces.)  Since the BBS prompt in
  3294.      the example was actually different than what The Liberator was expect-
  3295.      ing, you would select number 3 'Name' from screen 2, hit <Ctrl-End> to
  3296.      clear the entry, then enter the last few characters of what the BBS
  3297.      actually sent.  Up to twenty characters may be specified for any given
  3298.      prompt.  It is important that you make sure to enter enough from the BBS
  3299.      prompt/message to separate the prompt from regular text.  Punctuation is
  3300.      helpful here, as are trailing spaces, or anything else that will help
  3301.      The Liberator separate this text from the other text streaming in from
  3302.      the BBS.  "Name now: " would probably be adequate from the example
  3303.      prompt (without the quotes of course).  If you simpy defined "Name" as
  3304.  
  3305.  
  3306.  
  3307.  
  3308.      The  L i b e r a t o r  v2.32              Configuring Prompts - Page 52
  3309.      
  3310.      
  3311.  
  3312.      the prompt, then The Liberator would enter your name even if the word
  3313.      'name' happened to show up in the opening bulletins, so try to use
  3314.      enough to distinguish the prompt.
  3315.  
  3316.      You'll see that all the prompts have a double arrow following them, and
  3317.      this is to show any trailing spaces.  The trailing space isn't man-
  3318.      datory, but it does help to distinguish the prompt from other text, and
  3319.      normally also allows for a 0 Response Delay.
  3320.  
  3321.      Once you have the new prompt typed in, <Enter> it, then hit <Enter>,
  3322.      save the Configuration and re-try your Command File.
  3323.      One thing to watch when configuring prompts, is that you don't enter
  3324.      something that is likely to change.  For example, in the prompt "(115
  3325.      min. left) Main Board Command?" it would not be wise to enter the '115',
  3326.      since this changes according to how much time you have left.  Some
  3327.      prompts also pull double duty and are used for more than one operation. 
  3328.      For example, the 'Begin File Transfer' prompt on screen 2 signals The
  3329.      Liberator to start both PCBoard uploads and downloads.  Thus, you would
  3330.      not want to enter something like "Download time:" as the message to
  3331.      watch for, since the message will change to "Upload time:" when you
  3332.      perform an upload.
  3333.  
  3334.      The 'Pause' prompt, defined on screen 2, is used both on PCBoard and in
  3335.      ProDoor.  PCBoard uses 'Press (Enter) to continue?', while ProDoor uses
  3336.      'Press (Enter) to continue:' (with a colon instead of a question mark). 
  3337.      The last character is left out of the prompt, so it will be recognized
  3338.      in both formats.
  3339.  
  3340.      Another prompt that pulls double duty is the 'Enter file description'
  3341.      prompt, again on screen 2.  The text here signals The Liberator to start
  3342.      typing the file description, when uploading a file.  However, the same
  3343.      text must also work in ProDoor, so I chose text that is used in both
  3344.      places as the default.
  3345.  
  3346.  
  3347.  
  3348.  
  3349.      The  L i b e r a t o r  v2.32             Abort Codes/Remedies - Page 53
  3350.      
  3351.      
  3352.  
  3353.                              12.  ABORT CODES/REMEDIES
  3354.  
  3355.  
  3356.      If a Command File aborts, a message such as this will be printed on the
  3357.      screen, and stamped in the Usage Log:
  3358.  
  3359.      BBS1-A Command File Aborted (1).
  3360.  
  3361.      The number in the brackets is an abort code, and it is set to a specific
  3362.      number depending on the reason for the abort.  All abort codes and their
  3363.      possible remedies are listed here.  Note that The Liberator makes
  3364.      extensive use of the defined Usage Log, and you should also look here
  3365.      for any status/error messages to help debug a session.
  3366.  
  3367.      -1 Number One (LIBERATE.001), or another necessary module was not found,
  3368.         or there was not enough memory to load it.
  3369.       0 No fatal errors.  This doesn't mean that absolutely everything went
  3370.         off without a hitch, but only that no errors were serious enough to
  3371.         warrant aborting the Command File.  The Liberator can recover from
  3372.         many errors, and any of these may still have occurred.  Check the
  3373.         Usage File for error/status messages that are not covered here.
  3374.       1 Bad Command File.  This means that the Command File could not be
  3375.         found, or it was not the proper version, or there was a disk error
  3376.         attempting to read it.  If the file was not found, select 'Tools'
  3377.         from the main menu, then 'Configure' and check the 'Command File
  3378.         Directory'.  Change to the directory where the file can be found, or
  3379.         copy the file into the defined directory.  If the file was an older
  3380.         version, use the Tools 'Convert' option.  If there was a disk error,
  3381.         try again or try 'Edit'ing the file, and re-saving it.
  3382.       2 Bad Configuration File.  Same as number 1 above, but the BBS Con-
  3383.         figuration was bad.  See number 1 for possible remedies.
  3384.       3 Nothing to do.  Once the Command File was checked, no jobs remained
  3385.         to be carried out.  This could occur by saving a Command File but
  3386.         forgetting to define any jobs, or if for example, you requested only
  3387.         an upload, and your Upload List was not found.  Once the upload was
  3388.         cancelled, no jobs would remain to carry out.
  3389.       4 Master running, and no entry #'s to dial.  You cannot run Command
  3390.         Files with RunMaster that are set for interactive dialing directory
  3391.         selection (no entry numbers defined).  When you run the Master, it is
  3392.         assumed you are not present and thus you would not be able to select
  3393.         the entries to dial.
  3394.       5 Invalid entry number(s) to dial.  This occurs if, for example, you
  3395.         enter 56 as an entry, but your directory only goes up to 30.  This
  3396.         can occur when you delete entries, or sort your directory, etc. 
  3397.         Check the defined entry numbers by 'Edit'ing the BBS Configuration,
  3398.         selecting item 2 from screen 1, and hit <Alt-D> to compare the
  3399.         entries to your dialing directory.  Redefine as necessary.
  3400.       6 No password in Dialing Directory entry.  The entry connected to did
  3401.         not have a password defined (due to the way Telix works, The
  3402.         Liberator unfortunately does not know if a password is defined until
  3403.         AFTER connecting...).  To remedy, 'Edit' the appropriate BBS
  3404.         Configuration, select 'Telix Directory Numbers to Dial' from screen
  3405.         1, and take note of and check each entry by hitting <Alt-D> to view
  3406.  
  3407.  
  3408.  
  3409.  
  3410.      The  L i b e r a t o r  v2.32             Abort Codes/Remedies - Page 54
  3411.      
  3412.      
  3413.  
  3414.         the Telix Directory.  Highlight the appropriate entry(s) and type 'E'
  3415.         for Edit.  Check near the bottom in the 'Password' entry, and enter
  3416.         your PCBoard password in the entry.
  3417.       7 Custom Logon Script not found/returned abort code.  The defined Logon
  3418.         script was not found, or it returned a value other than 0 or 1.  If
  3419.         the file was not found, check the BBS Configuration to ensure the
  3420.         name was entered correctly, and if so, then type <Alt-J> to shell to
  3421.         DOS and copy the *compiled* script (run CS.EXE if necessary) into
  3422.         your Script directory.  Type EXIT when done, and retry the Command
  3423.         File.  If the script returned an abort code, it should have informed
  3424.         you as to the reason.  Check your Telix Usage Log.
  3425.       8 Bad password (not accepted by PCBoard).  The password you entered in
  3426.         the dialing directory was rejected 3 times by the BBS.  Check the
  3427.         appropriate Telix Dialing directory entry by hitting <Alt-D>, moving
  3428.         the highlight bar to the proper entry, and typing 'E' for Edit.  Hit
  3429.         <Enter> to move down to the 'Password' entry and change fix the
  3430.         password as necessary.  Try a manual logon to confirm the correct
  3431.         password has been entered.
  3432.       9 Script called in Custom Command returned abort code.  As mentioned in
  3433.         the Custom Commands section, if a script run from a Custom Command
  3434.         (using @SCRIPT), returns a value other than 0 or 1, this signals an
  3435.         abort to The Liberator, and thus you received this abort code.  The
  3436.         script that sent the abort code should inform you as to the reason. 
  3437.         If it gave no reason and appeared to complete normally, check the
  3438.         main() function of the script for return() statements.  Anything
  3439.         other than return, return(0), or return(1) will cause The Liberator
  3440.         to abort the Command File.  Edit out the offending return() and
  3441.         recompile the script.
  3442.      10 Unable to locate a recognizable BBS prompt.  Before starting each
  3443.         job, The Liberator reads the screen and attempts to figure out where
  3444.         it is from any of eight key positions on PCBoard.  The eight
  3445.         locations are signified in each BBS Configuration with an asterisk
  3446.         (*) immediately following the prompt description.  If none of the
  3447.         positions are found, <Enter> is sent a couple of times and some other
  3448.         responses, in an attempt to get to a key location or get a recog-
  3449.         nizable prompt up.  If after three tries the program still can't
  3450.         figure out where it is, it aborts with this value.  See the section
  3451.         on 'Configuring Prompts' above for a fix.
  3452.      11 BBS time up.  The number of online minutes set in 'Online time to
  3453.         save' (option 12, BBS Configuration screen 1) was reached, causing
  3454.         further jobs to be aborted.  The Liberator can read the available
  3455.         online time from all the major PCBoard and door prompts (assuming the
  3456.         standard format is being used) and checks the available online time
  3457.         before starting each job.  If it is less than or equal to the time
  3458.         set in the BBS time up option, mentioned above, further jobs are
  3459.         cancelled and The Liberator logs off.  Reset the 'Online time to
  3460.         save' to a lower amount, or set to zero to turn off time checking.
  3461.      12 Maximum online time up.  When a Command File begins, a timer is
  3462.         started, and if the number of minutes set in 'Max Online time' is
  3463.         reached (option 12, BBS Configuration screen 1), further jobs are
  3464.         cancelled and the program logs off.  Increase the number of maximum
  3465.         minutes to remedy.
  3466.  
  3467.  
  3468.  
  3469.  
  3470.      The  L i b e r a t o r  v2.32             Abort Codes/Remedies - Page 55
  3471.      
  3472.      
  3473.  
  3474.      27 Operator abort.  <Esc> was hit to call up the Control Menu, and
  3475.         option 1 'Abort' was selected.
  3476.      28 Connection lost.  The connection with the BBS was unexpectedly lost. 
  3477.         There are dozens of reasons this might occur, including line noise,
  3478.         or a bad prompt somewhere when The Liberator is not using its prompt
  3479.         recognition/recovery routines.  Check the capture file or scrollback
  3480.         buffer <Alt-B> for the actual cause.
  3481.      29 Logon unsuccessful.  This occurs if a key prompt is not reached
  3482.         within three minutes after a connection, or if none of the sixteen
  3483.         logon prompts can be found after three attempts at getting one up.
  3484.      30 Max redials reached or operator aborted dialing.  It doesn't know
  3485.         which, since Telix returns the same value for both.  In any case, a
  3486.         connection was not established.
  3487.